공식 https://dev.frontapp.com/docs/mcp-server에 가서 대신 사용하십시오.

Model Context Protocol (MCP) 서버는 Frontapp의 고객 통신 플랫폼과 대형 언어 모델 (LLMs)을 통합합니다.

** /docs의 전체 문서보기**

개요

이 프로젝트는 LLM과 Frontapp의 API 사이의 브리지 역할을 하는 MCP 서버를 구현합니다. LLM을 활성화하고 자연적인 언어 명령을 사용하여 Frontapp 워크플로우를 활성화합니다.

서버는 Frontapp에서 webhooks를 사용하여 실시간 업데이트 및 이벤트 구동 자동화를 지원합니다.

특징

• ** 대화 관리**: 검색, 생성, 업데이트 및 대화 관리
• 문의 관리: 액세스 및 업데이트 연락처 정보
• 태그 관리: 대화에서 태그를 적용하고 제거
• Inbox 관리: 액세스 inbox 정보
• 사용자 관리: 자주 묻는 질문
• **Webhook 통합 **: Frontapp에서 실시간 이벤트 수신 및 처리
• Secure 인증: 웹훅 서명을 검증하고 API 인증 처리
• Secure Credential Storage: AES-256 암호화로 민감한 정보를 저장

Frontapp MCP Server

Please go to the official https://dev.frontapp.com/docs/mcp-server and use that instead.

A Model Context Protocol (MCP) server for integrating Large Language Models (LLMs) with Frontapp’s customer communication platform.

📚 View Full Documentation in /docs

Overview

This project implements an MCP server that acts as a bridge between LLMs and Frontapp’s API. It enables LLMs to access and manipulate Frontapp data (conversations, contacts, tags, etc.) and automate Frontapp workflows using natural language commands.

The server supports real-time updates and event-driven automation using webhooks from Frontapp.

Features

• Conversation Management: Retrieve, create, update, and manage conversations
• Contact Management: Access and update contact information
• Tag Management: Apply and remove tags from conversations
• Inbox Management: Access inbox information
• User Management: Retrieve user details
• Webhook Integration: Receive and process real-time events from Frontapp
• Secure Authentication: Verify webhook signatures and handle API authentication
• Secure Credential Storage: Store sensitive information with AES-256 encryption
• HTTPS Support: Secure communications with TLS/SSL encryption

Architecture

The MCP server follows a modular architecture:

1. API Gateway: Handles incoming requests from LLMs and webhooks from Frontapp
2. Request Handlers: Process requests from LLMs and interact with the Frontapp API
3. Webhook Handlers: Process webhooks from Frontapp and update LLM context
4. Frontapp API Client: Encapsulates the logic for interacting with the Frontapp API
5. Data Models: Define the structure of data exchanged between LLMs, the MCP server, and Frontapp
6. Configuration: Stores settings for the MCP server

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• Frontapp API credentials
• A publicly accessible URL for webhooks (for production use)

Installation

Installing via Smithery

To install frontapp-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @zqushair/frontapp-mcp --client claude

For detailed installation instructions, see the Installation Guide.

Quick start:

1. Clone the repository:

   git clone https://github.com/zqushair/Frontapp-MCP.git
   cd Frontapp-MCP
   

2. Install dependencies:

   npm install
   

3. Create and configure the .env file:

   cp .env.example .env
   # Edit the .env file with your Frontapp API credentials
   

4. Build and start the project:

   npm run build
   npm start
   

Documentation

Comprehensive documentation is available in the /docs directory:

• 📖 Main Documentation - Overview and introduction