ZD

zernio-dev/crisp-mcp

开发工具官方

本页由 AI 翻译,技术细节请以原文为准。 查看原文

14 stars 7 forks 质量 72 趋势 24MIT

Crisp客户支持平台的MCP服务器 - 通过Claude Code管理对话、消息和操作员

概览

MCP(模式背景协议)服务器,提供与Crisp客户支持平台互动的工具. 用克洛德代码或任何MCP相容客户端来管理支持对话,发送消息等. 您需要创建 Crisp Marketplace 插件以获取 API 证书 。 这就是: 2. 点击( 你需要一个Crisp账户) 1. 填入基本的插件信息: - : 类似"我的MCP集成"(只为您可见) - : "个人的MCP服务器集成" - : 选择"自动" - : 保持其私密性(除非您想要发布) 1. 转到插件的设置 第2页。 导航至第三节. 你会发现: - (这是你的 CRISP IDENTIFIER) - (这是你的 CRISP KEY) 1. 进入您的 Crisp Dashboard 2. 点击 (齿轮图标) 3. 转到 4. 您在 URL 中: app.crisp.chat/website/XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXX-XXXXXXXXXXXX 5. 或发现在 > 回到 Marketplace 插件设置中, 您需要启用所需的范围 : 1. 联合国.

概述(AI 翻译)

MCP(模式背景协议)服务器,提供与Crisp客户支持平台互动的工具. 用克洛德代码或任何MCP相容客户端来管理支持对话,发送消息等.

□ 安装

□ 获取您的 Crisp API 证书

您需要创建 Crisp Marketplace 插件以获取 API 证书 。 这就是:

第1步:进入市场

  1. 前往Crisp市场
  2. 点击 ** “ 创建插件” ** (需要 Crisp 账户)

QQ 第 2 步 : 创建您的插件

  1. 填写基本插件信息:
  • 名:类似"我的MCP集成"(只为您可见).
  • ** 描述**:“个人MCP服务器集成”
  • 类别:选择“自动”
  • 隐私:保持保密(除非你想发表)
  1. 点击 ** “创建插件” **

步骤3:获得你的全权证书

创建插件后 :

  1. 转到插件的设置页面
  2. 导航到**“托肯斯”**节
  3. 你会发现:
  • ** Plugin ID**(这是你的[T0])
  • ** Plugin 密钥**(这是您的 CRISP_KEY)

QQ 第4步:获取您的网站ID

  1. 进入您的 Crisp Dashboard
  2. 点击 ** 设置 ** (工具图标) 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 新手?先看 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" } } } }