ZD

zernio-dev/crisp-mcp

Developer tools공식

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

14 stars 7 forks 품질 72 트렌드 24MIT

Crisp 고객 지원 플랫폼을위한 MCP 서버 - Claude Code를 통해 대화, 메시지 및 운영자 관리

개요

Crisp 고객 지원 플랫폼과 상호 작용하는 도구를 제공하는 MCP (모델 Context Protocol) 서버. Claude Code 또는 MCP 호환 클라이언트를 사용하여 지원 대화를 관리하고 메시지를 보내고, 더 많은 것을 보내십시오. Crisp Marketplace 플러그인을 만들고 API 자격 증명을 얻을 필요가 있습니다. 다음 방법: 1. Crisp Marketplace 2. 클릭 (Crisp 계정이 필요합니다) 1. 기본 플러그인 정보 작성 : - : "내 MCP 통합"과 같은 뭔가 (당신은 볼 만) - : "Personal MCP 서버 통합" - : "자동화"를 선택 - : 개인 유지 (당신은 게시 할 필요) 1. 플러그인 설정 페이지로 이동 2. 섹션 3에 Navigate 찾을 수 있습니다 : - (이것은 CRISP IDENTIFIER입니다) - (이것은 CRISP KEY입니다) 1. Crisp Dashboard 2. 클릭 (그레이 아이콘) 3. 이동 4. 귀하의 URL에: app.crisp.chat/website/XXXXX-XXXX-XXXX-XXXX-XXX-XXXXXX-XXX/XXX 5. 또는 그것을 찾을 > 마켓 플레이스 플러그인 설정에서 필요한 범위를 활성화해야합니다. 1. 명세.

개요(AI 번역)

Crisp 고객 지원 플랫폼과 상호 작용하는 도구를 제공하는 MCP (모델 Context Protocol) 서버. Claude Code 또는 MCP 호환 클라이언트를 사용하여 지원 대화를 관리하고 메시지를 보내고, 더 많은 것을 보내십시오.

설치

Crisp API Credentials 받기

Crisp Marketplace 플러그인을 만들고 API 자격 증명을 얻을 필요가 있습니다. 다음 방법:

단계 1: 시장 접근

  1. Crisp Marketplace로 이동
  2. Click “클립” (Crisp 계정 필요)

단계 2: 플러그인 만들기

  1. 기본 플러그인 정보 작성:
  • Name: "My MCP Integration"과 같은 것 (만 볼 수 있습니다) -Description: “개인 MCP 서버 통합”
  • Category: “자동화” 선택
  • Privacy: 개인 유지 (당신은 게시 할 필요)
  1. 클릭 “클립 플러그인”

단계 3: 당신의 잠재력을 얻으십시오

플러그인 만들기 후:

  1. 플러그인 설정 페이지로 이동
  2. ** “Tokens”** 섹션으로 이동
  3. 당신은 찾아낼 것입니다: -Plugin ID (이것은 CRISP_IDENTIFIER)
  • **Plugin 비밀 키 ** (이것은 당신의 CRISP_KEY)

단계 4: 당신의 웹사이트 ID를 얻으십시오

  1. Crisp 대시보드로 이동
  2. ** 설정** (gear icon)
  3. 명세.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Crisp MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the Crisp customer support platform. Use it with Claude Code or any MCP-compatible client to manage support conversations, send messages, and more.

Installation

git clone https://github.com/zernio-dev/crisp-mcp.git
cd crisp-mcp
npm install
npm run build

Getting Your Crisp API Credentials

You’ll need to create a Crisp Marketplace plugin to get API credentials. Here’s how:

Step 1: Access the Marketplace

  1. Go to Crisp Marketplace
  2. Click “Create a Plugin” (you need a Crisp account)

Step 2: Create Your Plugin

  1. Fill in the basic plugin info:

    • Name: Something like “My MCP Integration” (only visible to you)
    • Description: “Personal MCP server integration”
    • Category: Select “Automation”
    • Privacy: Keep it private (unless you want to publish)
  2. Click “Create Plugin”

Step 3: Get Your Credentials

After creating the plugin:

  1. Go to your plugin’s settings page
  2. Navigate to the “Tokens” section
  3. You’ll find:
    • Plugin ID (this is your CRISP_IDENTIFIER)
    • Plugin Secret Key (this is your CRISP_KEY)

Step 4: Get Your Website ID

  1. Go to your Crisp Dashboard
  2. Click on Settings (gear icon)
  3. Go to Website Settings
  4. Your Website ID is in the URL: app.crisp.chat/website/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/
  5. Or find it under Setup Instructions > Website ID

Step 5: Configure Plugin Permissions

Back in the Marketplace plugin settings, you need to enable the required scopes:

  1. Go to your plugin’s “Permissions” tab

  2. Enable these scopes:

    • website:conversation:sessions - Read conversations
    • website:conversation:messages - Read/write messages
    • website:conversation:states - Change conversation states
    • website:conversation:routing - Assign conversations
    • website:conversation:metas - Read/write metadata
    • website:operators:list - List team members
    • website:visitors:list - List visitors
  3. Click “Save”

Step 6: Install Plugin on Your Website

  1. Go to the “Installations” tab in your plugin settings
  2. Click “Add Installation”
  3. Select your website
  4. Confirm the installation

You’re now ready to use the MCP server!

Configuration

Set these environment variables:

Variable Description Example
CRISP_IDENTIFIER Your plugin ID from Marketplace ab1c2d3e-4f5g-6h7i-8j9k-0l1m2n3o4p5q
CRISP_KEY Your plugin secret key a1b2c3d4e5f6... (long string)
CRISP_WEBSITE_ID Your website ID 12345678-1234-1234-1234-123456789012

Usage with Claude Code

Add this to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "crisp": {
      "command": "node",
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "crisp": { "command": "node", "args": ["/path/to/crisp-mcp/dist/index.js"], "env": { "CRISP_IDENTIFIER": "your-plugin-id", "CRISP_KEY": "your-plugin-secret-key", "CRISP_WEBSITE_ID": "your-website-id" } } } }