跳至内容
MCP

把 ADITUS 文档带进你的编程助手。

一个覆盖 API 参考和 Micro Frontend 指南的公开只读 MCP 服务器。无需账号和密钥:通过目录一键启用、无需任何配置,或添加一个 URL,Claude、Cursor、Copilot 或 ChatGPT 就能查阅真实契约,而不是靠猜。

https://developers.aditus.com/api/mcp

可在以下平台获取 …

服务器已发布在以下目录中。在那里一键启用,无需配置文件。

  • Claude

    在 Claude 中直接作为连接器启用:一键完成,无需配置片段。

    在 Claude 中打开
  • Official MCP Registry

    官方服务器条目(com.aditus.developers/developer-portal),支持注册表的客户端可直接导入。

    打开列表页
  • Glama

    连接器页面,含工具概览和浏览器内检查器。

    打开列表页
  • Smithery

    列表页提供多种客户端的安装命令和托管的在线试用环境。

    打开列表页

手动设置

仅当你的客户端不支持目录时才需要。Streamable HTTP,无需认证,无会话状态。选择你的客户端:

Claude Code:在终端中运行一次此命令,之后每个会话都可使用该服务器。

Claude Code
claude mcp add --transport http aditus-docs https://developers.aditus.com/api/mcp

Cursor:将此内容放入项目文件夹中的 .cursor/mcp.json(或 ~/.cursor/mcp.json 以对所有项目生效)。

Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "aditus-docs": {
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

VS Code 与 Copilot:将此内容放入项目文件夹中的 .vscode/mcp.json,或通过“MCP: Add Server”添加到用户设置。

VS Code / Copilot · .vscode/mcp.json
{
  "servers": {
    "aditus-docs": {
      "type": "http",
      "url": "https://developers.aditus.com/api/mcp"
    }
  }
}

Claude Desktop:打开 设置 → 开发者 → 编辑配置,将此内容粘贴到 claude_desktop_config.json 并重启应用。

Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "aditus-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://developers.aditus.com/api/mcp"]
    }
  }
}

ChatGPT:在 设置 → 连接器 中,用上方的端点 URL 添加一个自定义连接器,无需配置片段。若想不借助客户端直接试用服务器,在终端中运行:

curl
curl -s https://developers.aditus.com/api/mcp \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_docs","arguments":{"query":"create cart"}}}'

支持 server card 的客户端可在此发现同一服务器:/.well-known/mcp/server-card.json.

工具

五个只读工具。内容来自与 API 参考和 /ai 下 Markdown 镜像相同的脱敏集合快照,因此三者始终一致。

Tool参数返回
search_docsquery, limit?在模块、端点和指南中按相关性排序的全文搜索。
list_modules–所有 API 模块及其方向、端点数量和链接,以及各指南。
list_endpointsmodule某个模块的全部端点,含方法、路径和一句话摘要。
get_endpointendpoint完整契约:参数、请求头、请求体和示例响应。
get_guideguide, section?Micro Frontend 指南(代理指南、完整文档、概览)、Guidelines 或 Webhooks 的 Markdown,可整篇或按章节获取。

示例提示

三个典型问题,以及提问之后会发生什么。

  1. “如何通过 ADITUS Shop API 创建购物车并添加门票?”

    助手调用 search_docs("create cart add item"),再对匹配的两个端点调用 get_endpoint,然后给出请求顺序、必需的请求头和正文字段以及示例响应。

  2. “如何验证 ADITUS webhook 的签名?”

    助手调用 get_guide("webhooks", "signature"),返回确切的请求头名称、签名算法和你所用语言的验证代码片段,并引用指南章节。

  3. “ADITUS 有哪些门禁控制 API?哪个端点可以读取门票的扫描记录?”

    助手调用 list_modules,选择门禁模块,对其调用 list_endpoints,再对扫描记录端点调用 get_endpoint,然后给出模块概览以及该端点的参数和响应字段。

数据与隐私

无需账号和密钥,你的对话也永远不会到达服务器:你的助手只发送工具名称及其参数(搜索词、模块、端点或指南 ID)。出于运维目的,每个请求会记录 JSON-RPC 方法、工具名称、这些参数(各截断至 200 个字符)、HTTP 状态、错误或拒绝原因、结果数量、耗时、来自 initialize 的客户端名称、版本和协议版本、客户端的 user-agent,以及 IP 地址的短带密钥哈希(HMAC);绝不存储地址本身。日志行在 90 天后删除(启动时及每六小时清理一次),仅保留在 ADITUS 内部,不与第三方共享。回答仅来自公开文档。有疑问请联系:联系我们 · 隐私政策