AI导哈

模型上下文协议演示服务器

一个用于展示如何使用Crisp构建和使用MCP的演示服务器，提供用户、订单和产品的模拟数据查询功能。

  • by Qimath
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Qimath/crisp-mcp-demo

使用说明

Crisp MCP演示服务器

演示MCP（模型上下文协议）服务器，展示如何使用Crisp构建和使用MCP。

此存储库可作为希望尝试MCP的开发人员的参考实现。它已准备好部署、测试或构建。

它公开了一个MCP端点，其中包含三个由模型数据支持的工具：

  • get_user → 通过以下方式获取用户 email
  • get_order → 通过以下方式获得订单 id
  • get_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 → 编译TypeScript
  • npm run start → 运行已编译的服务器
  • npm run tunnel → 通过Cloudflare隧道公开localhost
  • npm 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服务器：

  1. 命名它
  2. 击打 从服务器刷新工具 如果你的工具没有自动取出
  3. 启用MCP服务器
  4. 点击 保存更改 按钮

步骤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 每个请求的标题

相关 MCP