AI Agent
MCP Server 配置
`<vault>/.kition/mcp.json` 配 stdio / SSE / HTTP server，重启 Agent 生效。
MCP 是什么
Model Context Protocol（MCP）是 Anthropic 提出的开放协议，让 AI Agent 通过统一接口接入外部工具与数据源 — 比如 GitHub、Jira、Notion、你自己的内部 API。
Kition 内置 MCP client，所以任何符合协议的 server 都能直接挂上。这意味着 npm 上、GitHub 上、你公司内部的现成 MCP server 拿来即用，不需要为 Kition 单独写适配。
三种 Transport
stdio— 启子进程，通过标准输入输出通信。最常见，适合本地工具sse— Server-Sent Events，适合长连接的远程 serverhttp— 标准 HTTP，请求/响应模型，适合无状态 server
完整配置示例
{
"mcpServers": {
"github": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
},
"postgres-readonly": {
"transport": "stdio",
"command": "uvx",
"args": [
"mcp-server-postgres",
"postgres://reader@localhost:5432/analytics"
]
},
"internal-api": {
"transport": "http",
"url": "https://mcp.internal.example.com",
"headers": {
"Authorization": "Bearer $INTERNAL_MCP_TOKEN"
}
}
}
}环境变量怎么注入
$NAME 形式从你的 OS 环境读取；${NAME:-fallback} 提供默认值。Token 这类敏感信息推荐用 Kition 内置的 Keychain 集成 — ${kition:secret:gh-token} 会从系统 Keychain 取，不落 JSON。
挂上之后做什么
- 重启 Agent 面板（或在 Settings → Agent → MCP 点 Reload）
- 在对话里问 "what MCP tools do I have?" 看 Agent 列出
- 工具名带 server 前缀 —
github:create_issue、postgres-readonly:query - 每个 server 都进 Permissions 模型 — 单独配 allow / ask / deny
调试不能用的 server
Settings → Agent → MCP → Logs 里有每个 server 的启动日志和 protocol trace。stdio server 通常因为 PATH 找不到命令而起不来 — 用绝对路径或在 env 里补 PATH。
远程 server 的 401 / 403 几乎都是 token 注入失败 — 用 echo $TOKEN 在 Bash 工具里验一下 env 是否生效。