// Agent 工具 · 接入指南
装 MCP、写规则、加 Skills 时最常问的：每个编程 agent 的配置文件在哪、怎么加，它默认能自己做多少事。一张表看清，全部来自官方文档。
11 个 agent核对于 2026-10-22MCP 规范 2026-07-28只引官方文档
~ 指用户主目录。项目级文件可以提交进仓库，团队共用。
| Agent | MCP 配置文件 | 命令行添加 | 传输方式 | 规则文件 | Skills 目录 |
|---|---|---|---|---|---|
| Claude CodeAnthropic · CLI / IDE / Desktop / Web | ~/.claude.json (local / user scope).mcp.json (project scope, shared) | claude mcp add --transport http <name> <url> | stdio · HTTP · SSE (deprecated) · WebSocketOAuth ✓ | CLAUDE.md / .claude/CLAUDE.mdCLAUDE.local.md~/.claude/CLAUDE.md.claude/rules/AGENTS.md (read when present) | .claude/skills/<name>/SKILL.md~/.claude/skills/ |
| Codex (CLI · IDE · ChatGPT desktop)OpenAI · CLI / IDE / Desktop | ~/.codex/config.toml → [mcp_servers.<name>].codex/config.toml (trusted projects only) | codex mcp add <name> -- <command> | stdio · Streamable HTTPOAuth ✓ | AGENTS.md (repo root → cwd)AGENTS.override.md~/.codex/AGENTS.md | .agents/skills/ (cwd → repo root)~/.agents/skills//etc/codex/skills |
| Cursor (editor · CLI)Anysphere · IDE / CLI | .cursor/mcp.json (project)~/.cursor/mcp.json (global) | 界面或改文件 | stdio · SSE · Streamable HTTPOAuth ✓ | .cursor/rules/*.mdcAGENTS.mdUser Rules / Team Rules (settings) | .agents/skills/.cursor/skills/~/.agents/skills/~/.cursor/skills/.claude/skills/ · .codex/skills/ (compat) |
| GitHub Copilot (VS Code · Copilot CLI)GitHub · IDE / CLI / Cloud | .vscode/mcp.json (VS Code)~/.copilot/mcp-config.json (CLI).mcp.json · .github/mcp.json (CLI, per repo) | copilot mcp add · /mcp add | stdio · HTTP | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.md / GEMINI.md (repo root) | .github/skills/.claude/skills/.agents/skills/~/.copilot/skills/~/.agents/skills/ |
| Antigravity CLIGoogle · CLI / Desktop⚠ 2026-05-19 发布，取代 Gemini CLI：2026-06-18 起 Gemini CLI 不再服务免费、Google AI Pro / Ultra 个人用户 | ~/.gemini/config/mcp_config.json (global).agents/mcp_config.json (workspace) | 界面或改文件 | stdio · SSE · Streamable HTTP · WebSocket | GEMINI.mdAGENTS.md~/.gemini/GEMINI.md | .agents/skills/~/.gemini/antigravity-cli/skills/ |
| Gemini CLIGoogle · CLI⚠ 仅企业（Gemini Code Assist 许可）和 API key 用户还能用；个人用户请换 Antigravity CLI | ~/.gemini/settings.json → mcpServers.gemini/settings.json (project, default scope) | gemini mcp add <name> <command|url> | stdio · SSE · Streamable HTTPOAuth ✓ | GEMINI.md (context.fileName configurable)~/.gemini/GEMINI.md | .gemini/skills/ · .agents/skills/~/.gemini/skills/ · ~/.agents/skills/ |
| Devin Desktop / Devin CLI (formerly Windsurf)Cognition · IDE / CLI / Cloud⚠ Windsurf 于 2026-06-02 更名为 Devin Desktop；默认本地 agent 由 Cascade 换成 Devin Local（与 Devin CLI 共用配置） | .devin/mcp_config.local.json (local, default).devin/mcp_config.json (project)~/.config/devin/mcp_config.json (user) | devin mcp add <name> <url> | stdio · Streamable HTTP · SSEOAuth ✓ | AGENTS.md~/.config/devin/AGENTS.md.devin/rules/ (legacy .windsurf/rules/) | .agents/skills/.devin/skills/ (legacy .windsurf/skills/)~/.agents/skills/~/.config/devin/skills/ |
| ClineCline · IDE / CLI | cline_mcp_settings.json (extension: MCP Servers → Configure)~/.cline/data/settings/cline_mcp_settings.json (CLI) | 界面或改文件 | stdio · Streamable HTTP (recommended) · SSE (legacy) | .clinerules/ · .cline/rules/AGENTS.md · ~/.agents/AGENTS.md.cursorrules · .windsurfrules (auto-detected) | .cline/skills/ · .clinerules/skills/.claude/skills/~/.cline/skills/ |
| OpenCodeAnomaly · CLI / IDE / Desktop | opencode.json(c) → "mcp" (type: local | remote) | 界面或改文件 | local (stdio) · remote (HTTP)OAuth ✓ | AGENTS.md~/.config/opencode/AGENTS.mdCLAUDE.md · ~/.claude/CLAUDE.md (fallback) | .opencode/skills/~/.config/opencode/skills/.claude/skills/ · ~/.claude/skills/.agents/skills/ · ~/.agents/skills/ |
| Kiro (IDE · CLI)AWS · IDE / CLI / Web | .kiro/settings/mcp.json (workspace)~/.kiro/settings/mcp.json (user) | 界面或改文件 | stdio · remote HTTPSOAuth ✓ | .kiro/steering/~/.kiro/steering/AGENTS.md | .kiro/skills/~/.kiro/skills/ |
| Qwen CodeAlibaba Qwen · CLI | ~/.qwen/settings.json (user, default).qwen/settings.json (project) | qwen mcp add --transport http <name> <url> | stdio · Streamable HTTP · SSEOAuth ✓ | QWEN.md (context.fileName configurable) | .qwen/skills/~/.qwen/skills/ |
数字来自上表。
“未写明”表示我们核对的官方文档没写，不代表没有这个功能。
⚠ 2026-05-19 发布，取代 Gemini CLI：2026-06-18 起 Gemini CLI 不再服务免费、Google AI Pro / Ultra 个人用户
⚠ 仅企业（Gemini Code Assist 许可）和 API key 用户还能用；个人用户请换 Antigravity CLI
⚠ Windsurf 于 2026-06-02 更名为 Devin Desktop；默认本地 agent 由 Cascade 换成 Devin Local（与 Devin CLI 共用配置）
Devin CLI MCP ↗Rules & AGENTS.md ↗Skills ↗Sandbox ↗Windsurf → Devin Desktop FAQ ↗
AGENTS.md：本页 11 个客户端里有 9 个会读它（Claude Code、Codex、Cursor、GitHub Copilot、Antigravity CLI、Devin Desktop / Devin CLI、Cline、OpenCode、Kiro）。通用规则写在这里，各家专属文件只放差异。
.agents/skills/<name>/SKILL.md——11 个里有 7 个会扫描这个目录。Claude Code 读 .claude/skills/，Cursor、Copilot、Cline、OpenCode 也兼容读取它。
大体可以，但要改几处：Claude Code 里带 url 的条目必须写 "type": "http"；Antigravity CLI 远程服务器要用 serverUrl（不认 url / httpUrl）；Codex 用 TOML（[mcp_servers.<名字>]）；OpenCode 用 "mcp" 键并写 type: local/remote。
2026-06-18 起，Gemini CLI 不再服务免费和 Google AI Pro / Ultra 个人用户；企业许可和 API key 用户仍可用。个人用户官方建议换 Antigravity CLI，它会导入技能、MCP 和 GEMINI.md。
数据更新于：Agent 接入指南（北京时间）