xiantong 文档

概览

通过 MCP 将你的 Agent 连接到服务

将你的 Agent 连接到你每天使用的服务——GitHub、搜索引擎、数据库、内部工具等等。MCP(Model Context Protocol)是实现它的标准,许多服务现在开箱即提供 MCP 支持。

你可以连接哪些服务?#

当你将 MCP 服务器连接到一个来源后,你的 Agent 即可访问该服务的功能。连接 GitHub 后,Agent 可以检查 PR 状态、总结 issue,并自动更新你的 xiantong 文档。连接一个数据库,它可以直接查询你的数据。连接 Slack,它可以向你的团队发布更新。每个连接都会为 Agent 添加新的工具,Agent 可以在对话中自然使用这些工具——无需写代码。

为什么使用 MCP 服务器?#

  • 连接你的技术栈

GitHub、Slack、数据库、搜索引擎、内部工具——只要支持 MCP,你的 Agent 就能使用。

  • 构建真实工作流

将服务串联起来:从一个获取数据、处理,再推送到另一个。

  • 标准化且安全

MCP 提供一致的集成模式,并为每个来源限定凭据范围。

  • 不断扩展的生态系统

越来越多的服务持续添加 MCP 支持——查看 MCP 服务器注册表

来源配置#

MCP 服务器按照特定 schema 配置为来源:

{
"type": "mcp",
"name": "Server Name",
"tagline": "Description of the server",
"icon": "https://example.com/icon.png",
"mcp": {
"transport": "http",
"url": "https://mcp-server.example.com",
"authType": "oauth"
}
}

配置字段#

字段是否必需说明
type对于 MCP 服务器必须是 "mcp"
name服务器的显示名称
tagline服务器用途的简短描述
icon图标 URL、表情或本地文件(自动发现:icon.svgicon.png
mcp.transport传输类型:默认 "http",本地服务器可选 "sse""stdio"
mcp.url是(HTTP/SSE)MCP 服务器端点的完整 URL(用于 HTTP/SSE 传输)
mcp.command是(stdio)运行本地服务器的命令(用于 stdio 传输)
mcp.args否(stdio)命令参数(用于 stdio 传输)
mcp.authType是(HTTP/SSE)身份验证类型:"oauth""bearer""none"。stdio 不需要此项。

传输类型#

HTTP/SSE 传输(远程服务器)#

用于通过网络访问的远程 MCP 服务器:

{
"type": "mcp",
"name": "Exa Search",
"tagline": "Neural search for the web",
"icon": "https://exa.ai/icon.png",
"mcp": {
"transport": "http",
"url": "https://mcp.exa.ai/mcp",
"authType": "bearer"
}
}

HTTP 传输自动支持可流式 HTTP 和服务器发送事件(SSE)协议。

stdio 传输(本地服务器)#

用于在你的机器上作为进程运行的本地 MCP 服务器:

{
"type": "mcp",
"name": "MCP Name",
"tagline": "MCP Description",
"mcp": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@package/name", "/path/to/directory"]
}
}

常见的本地服务器模式:

模式示例命令
npx 包"command": "npx", "args": ["-y", "package-name"]
Node 脚本"command": "node", "args": ["/path/to/server.js"]
Python 脚本"command": "python", "args": ["/path/to/server.py"]
二进制"command": "/usr/local/bin/mcp-server"

查找 MCP 服务器#

许多服务都提供 MCP 服务器。以下是一些查找它们的途径:

  • MCP 服务器注册表 - 官方可用服务器列表
  • 服务文档 - 许多 API 现在提供 MCP 端点
  • 自托管 - 为内部工具运行你自己的 MCP 服务器

需要 Google、Microsoft 或 Slack 吗? xiantong Agent 内置了对这些服务的 OAuth 支持。只需告诉你的 Agent“连接 Google 日历”或“添加 Slack”,它就会带你完成 OAuth 流程——无需外部聚合器。

安全注意事项#

在将 MCP 服务器连接到你的来源时:

  • 来源和凭据是分域的 - 每个工作区都有各自的来源和存储的凭据。除非另行配置,否则来源不会在工作区之间共享。
  • 凭据已加密 - 安全存储在 ~/.xiantong/credentials.enc 中。

后续步骤#

连接服务器#

添加 MCP 服务器作为来源的分步指南。

身份验证#

配置 OAuth、Bearer 令牌和公开认证。