Crisp MCP演示服务器
演示MCP（模型上下文协议）服务器，展示如何使用Crisp构建和使用MCP。
此存储库可作为希望尝试MCP的开发人员的参考实现。它已准备好部署、测试或构建。
它公开了一个MCP端点，其中包含三个由模型数据支持的工具：
get_user→ 通过以下方式获取用户emailget_order→ 通过以下方式获得订单idget_product→ 通过以下方式获得产品id
_此演示是使用 @modelcontextprotocol类型脚本SDK.访问他们的仓库，了解有关MCP的更多详细信息和文档。_
I.安装与运行
_要开始使用此MCP服务器，您可以在本地运行它或使用托管版本。_
使用托管版本
此MCP服务器已托管在，如果您想快速测试，可以随时连接到您的Crisp工作区。 您可以在以下网址访问它：https://crisp-mcp-demo.fly.dev/mcp
在本地运行
先决条件：
- Node.js
24.x安装 - 键盘（可选，但推荐）
步骤1——克隆仓库
在所需文件夹中打开终端并运行：
git clone https://github.com/crisp-im/crisp-mcp-demo.git
cd crisp-mcp-demo步骤2——运行服务器
_您可以构建并启动服务器，也可以直接在开发模式下运行它。_
要构建和运行服务器，请使用：
npm ci
npm run build
npm run start或者使用tsx（监视模式）在开发模式下运行它，使用：
npm ci
npm run dev步骤3——公开服务器（如果在本地运行）
_如果你想在本地运行服务器，你需要通过隧道公开它 以便Crisp能够触及它。 此软件包已预先配置为使用Cloudflared，但您可以使用任何您喜欢的隧道解决方案。_
如果您的计算机上尚未安装Cloudflared， 点击此链接 要查找操作系统的安装说明：
安装后，打开一个新终端并运行：
npm run tunnel您可以访问隧道的url以确认其正常工作。你应该看到一条问候语。
可用脚本
npm run dev→ 开发服务器（监视）npm run build→ 编译TypeScriptnpm run start→ 运行已编译的服务器npm run tunnel→ 通过Cloudflare隧道公开localhostnpm run inspect→ 运行@modelcontextprotocol检查器
二、连接到Crisp
_本节是将此MCP服务器连接到Crisp工作区的快速入门指南。 我们还建议您查看 我们的官方文件 了解更多详细说明。_
先决条件：
- 一个Crisp账户
- Essentials或Plus计划中的Crisp工作区
步骤1--导航到 app.crisp.chat
第二步——在 AI 代理 菜单，前往 AI 代理→ 自动化→ 集成和MCP → 外部MCP服务器\*\*，然后单击\*\*添加MCP服务器\*\*区域。
步骤3--输入您的MCP服务器的URL（您的托管/隧道URL或 托管版本)并击中 添加MCP服务器.
步骤4——配置MCP服务器：
- 命名它
- 击打 从服务器刷新工具 如果你的工具没有自动取出
- 启用MCP服务器
- 点击 保存更改 按钮
步骤5--您的MCP服务器现在应该已注册并准备好使用！
III、 测试MCP服务器
_还在 自动化 菜单，你可以去 操场 测试您的MCP服务器和不同的AI模型。问一个问题！_
游乐场示例
一次性问题：
你能查一下我的订单退款吗 OID_002 是否已处理？嗨，我的帐户上启用了通知吗 baptiste@acme.com?AI可以链接多个工具调用（例如，查找您的accent、列出最近的订单并获取产品详细信息）：
这些是我订购的商品吗 OID_001 还在保修期内吗？我的最新订单什么时候交货？我是 chris@acme.com也可以尝试部分问题，让人工智能向你索取更多信息：
我上次订购的金额是多少？
我找不到我的追踪号码，你能帮我吗？
可用帐户和订单
- chris@acme.com
- OID_003 - OID_006
- baptiste@acme.com
- OID_001 - OID_004
- dinis@acme.com
- OID_002 - OID_005 - OID_007
MCP良好实践
MCP设计
- 服务器描述： 描述MCP服务器的一般用途
- 工具命名： 使用清晰明确的名称（例如。
get_order，不orderLookup) - 工具说明： 简要描述该工具的功能，何时调用它，
并可选地提供用例示例
- 架构： 为工具输入提供精确的模式，以确保正确使用
用户验证
在MCP服务器配置中，您还可以选择要求用户进行身份验证 在AI调用MCP工具之前。这加强了对敏感操作的安全性。
如果用户尚未通过身份验证，Crisp将通过电子邮件或短信向他们发送OTP代码 在允许AI调用您的MCP工具之前。
为此，只需导航到MCP服务器并点击 管理. 在每个工具上，您都可以切换 需要用户身份验证 选项。
服务器身份验证
在生产环境中，您可能希望限制对MCP服务器的访问，并防止未经授权的使用。 有两种身份验证方法可供选择：
- 承载令牌： 在中发送的静态令牌
Authorization每个请求的标题 - 基本身份验证： 在中发送的用户名和密码
Authorization每个请求的标题