概览
通过 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.svg、icon.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 令牌和公开认证。