> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit MCP 服务器：为 AI 智能体提供身份验证

> 将 Claude、Cursor、VS Code、Windsurf 及任意 MCP 客户端连接到 Didit。通过自然语言使用原生智能体 KYC、KYB 与 AML，支持托管或自托管。

**Didit MCP 服务器**可将任何 [Model Context Protocol](https://modelcontextprotocol.io) 客户端（Claude、Cursor、VS Code、Windsurf、Zed 等）直接连接到 Didit 身份平台。连接后，智能体即可通过自然语言指令执行 KYC、KYB、AML 筛查、交易监控，以及完整的工作区操作（工作流、会话、名单、Webhook、计费）。

这节 Didit Academy 课程通过 OAuth 将托管的 MCP 服务器连接到 Claude，然后用一条提示词构建 KYC 工作流，查询审核队列，并基于 90 天的历史记录回测交易规则。

[使用 Didit 与 MCP | Didit Academy](https://www.youtube.com/embed/I3UkFIhW548?rel=0\&playsinline=1)

> [!NOTE]
>
> Didit MCP 具有**读写权限**：智能体可以代表你创建会话、配置工作流、更新状态，并向你的名单中添加条目。每个客户端都会在工具调用运行前要求你审核，请保持此设置开启，尤其是对于写入和删除操作。

***

## 30 秒快速上手

最快的方式是使用**托管服务器**，只需一个 URL，无需 API 密钥。你的客户端会打开浏览器，你**使用 Didit 登录**并批准权限，即可完成连接。

```text Hosted endpoint theme={null}
https://mcp.didit.me/mcp
```

> [!TIP]
>
> **在 Claude 网页版上**，[**将 Didit 添加到 Claude →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp) 会预先填充连接器对话框，确认后使用 Didit 登录即可。完整操作说明请参阅[连接 Claude](https://docs.didit.me/zh/integration/mcp/claude.md)。源代码位于 [GitHub](https://github.com/didit-protocol/mcp)（MIT 许可）。

> [card] [在客户端中安装](https://docs.didit.me/zh/integration/mcp/installation.md)
>
> 适用于 Claude、Cursor、VS Code、Windsurf 和 Zed 的复制粘贴式设置。

> [card] [登录方式说明](https://docs.didit.me/zh/integration/mcp/authentication.md)
>
> “使用 Didit 登录”（采用 PKCE 的 OAuth 2.1），无需 API 密钥，配置中也不含任何机密信息。

> [card] [浏览工具](https://docs.didit.me/zh/integration/mcp/tools.md)
>
> 共 169 个工具，涵盖会话、工作流、独立检查、交易监控、名单、案件、报告和 Webhook。

> [card] [实际效果](https://docs.didit.me/zh/integration/mcp/examples.md)
>
> 示例提示词和端到端的智能体对话。

***

## 工作原理

托管的 MCP 是一个 OAuth 2.1 **资源服务器**；Didit 商业控制台（`business.didit.me`）是**授权服务器**。你通过一个 URL 进行连接，在浏览器中**使用 Didit 登录**，之后 MCP 即以**你**的身份运行，覆盖你所属的每个组织，并遵循你控制台角色的权限。

> [!NOTE]
>
> **MCP 以 Didit 用户身份运行，而非应用程序，不存在 API 密钥模式。** 每个工具调用的都是用户级控制台 endpoint，这些 endpoint 只接受你的 Bearer 令牌。（如需使用应用 API 密钥直接调用原始 REST API，例如从你自己的后端创建会话，请直接使用 [REST API](https://docs.didit.me/openapi-25.json)；它与本 MCP 是分开的。）

该服务器是无状态的 Streamable HTTP：每个请求对应一次 `POST https://mcp.didit.me/mcp`，不存在会话亲和性，并提供公开的健康检查 `GET https://mcp.didit.me/healthz`。

如果你更想自行运行服务器，也可以，请参阅[安装 → 自托管](https://docs.didit.me/zh/integration/mcp/installation.md#自托管)。它仍然通过 OAuth 对用户进行身份验证（或在无头 stdio 运行中使用用户 Bearer 令牌）。

工具会原样返回底层 Didit endpoint 的 JSON。完整说明请参阅[身份验证](https://docs.didit.me/zh/integration/mcp/authentication.md)。

***

## 你可以用它做什么

用自然语言提问即可。智能体可以同时跨**你的所有应用**完成以下操作：

* *“显示我所有应用中最近 5 个审核中的会话。”*
* *“有多少人尝试了电话验证但在过去 15 天内流失？”*
* *“创建一个包含证件扫描和活体检测的 KYC 工作流，然后给我一个验证链接。”*
* *“查找 vendor\_data 为 `user_8842` 的客户：他在哪个应用中，状态如何？”*
* *“对此钱包进行 AML 风险筛查，如果命中则将其加入黑名单。”*
* *“注册一个 Webhook 目标，以便将状态更新发送到我的 endpoint。”*
* *“本月我的额度余额和转化率是多少？”*

***

## 为智能体时代而生

大多数身份验证平台都需要手动进行控制台设置。Didit 则让智能体完成全部流程，端到端地**配置工作流**、**创建和审核会话**、**接入 Webhook**，并**监控计费**。将 MCP 与[一条提示词集成](https://docs.didit.me/zh/integration/integration-prompt.md)搭配使用，智能体即可交付完整的集成（后端路由 + 前端 SDK + Webhook 处理程序），同时调用 MCP 工具实时创建工作流和会话。

> [card] [安装](https://docs.didit.me/zh/integration/mcp/installation.md)
>
> 适用于 Claude、Cursor、VS Code、Windsurf、Zed 的各客户端设置，以及自托管。

> [card] [身份验证](https://docs.didit.me/zh/integration/mcp/authentication.md)
>
> OAuth 登录、权限范围和角色。

> [card] [工具参考](https://docs.didit.me/zh/integration/mcp/tools.md)
>
> 按领域分组的所有工具，并附带其权限范围和角色权限。

> [card] [高级与故障排查](https://docs.didit.me/zh/integration/mcp/advanced.md)
>
> 角色、跨应用行为、分支工作流、Webhook 和自托管。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.