Composio MCP 实战：为 AI Agent 集成 200+ 外部工具与工作流

首先通过 pip 安装核心库：

pip install composio-core
pip install composio-claude  # Claude Agent 专用插件

安装完成后，登录 Composio 控制台获取 API Key：

composio login

浏览器会打开 OAuth 授权页面，授权后 API Key 将自动保存到 ~/.composio/config。

在 Claude Desktop 或兼容的 MCP Client 中，添加 Composio 作为 MCP Server。编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "composio": {
      "command": "composio",
      "args": ["mcp", "run"],
      "env": {
        "COMPOSIO_API_KEY": "你的 API_KEY"
      }
    }
  }
}

重启 Claude Desktop 后，右下角会出现 Composio 图标，表示 MCP 连接成功。

Composio 支持 200+ 工具，但无需全部启用。通过 CLI 激活需要的工具：

# 启用 Slack 发消息
composio apps enable slack

# 启用 GitHub 操作
composio apps enable github

# 启用 Notion 文档管理
composio apps enable notion

# 查看已启用的工具
composio apps list

每个工具会自动处理 OAuth 流程。首次使用时，Composio 会弹出浏览器让你授权：

composio triggers subscribe slack_send_message

创建一个简单的 Agent，让它自动发送 Slack 消息：

from claude_agent import Agent
from composio_claude import ComposioToolSet

# 初始化 Composio 工具集
toolset = ComposioToolSet(api_key="你的 API_KEY")

# 获取 Slack 发送消息工具
slack_tool = toolset.get_tool("slack_send_message")

# 创建 Agent 并注册工具
agent = Agent(
    name="Slack Bot",
    tools=[slack_tool],
    instructions="你是一个 Slack 助手，帮助用户发送消息到指定频道"
)

# 运行 Agent
response = agent.run("发送 '下午 3 点开会' 到 #general 频道")
print(response)

Agent 会自动解析用户意图，调用正确的工具，并返回执行结果。

真实场景往往需要串联多个工具。以下示例展示了一个完整的 CI/CD 通知工作流：

from claude_agent import Agent
from composio_claude import ComposioToolSet

toolset = ComposioToolSet()

# 注册多个工具
agent = Agent(
    name="CI/CD Notifier",
    tools=[
        toolset.get_tool("github_get_commit"),
        toolset.get_tool("slack_send_message"),
        toolset.get_tool("notion_create_page")
    ],
    instructions="""你是一个 CI/CD 通知助手。当收到部署成功事件时：
1. 获取最新 commit 信息
2. 发送 Slack 通知到工程频道
3. 在 Notion 创建发布记录页"""
)

# 触发工作流
response = agent.run(
    "部署成功！repo: my-app, commit: abc123, env: production"
)

当工具数量较多时，使用 Tool Search 动态选择，避免 context 爆炸：

from composio_claude import ComposioToolSet

toolset = ComposioToolSet()

# 基于任务描述搜索相关工具
tools = toolset.search_tools(
    query="发送消息到 Slack 并创建 Notion 文档",
    limit=5  # 只返回最相关的 5 个工具
)

print(f"找到 {len(tools)} 个相关工具")
for tool in tools:
    print(f"- {tool.name}: {tool.description}")

输出示例：

找到 5 个相关工具
- slack_send_message: 发送消息到指定 Slack 频道
- slack_upload_file: 上传文件到 Slack
- notion_create_page: 在 Notion 创建新页面
- notion_update_page: 更新现有 Notion 页面
- gmail_send_email: 发送邮件（备选通知方式）

生产环境必须处理 API 失败、权限不足、限流等异常情况：

from composio.exceptions import ComposioAPIError, RateLimitError

async def send_notification(message, channel="#general"):
    try:
        result = await slack_tool.execute({
            "channel": channel,
            "text": message
        })
        return {"success": True, "data": result}
    except RateLimitError as e:
        # 降级：改用邮件通知
        await gmail_tool.execute({
            "to": "team@example.com",
            "subject": "Slack 限流，转为邮件通知",
            "body": message
        })
        return {"success": False, "fallback": "email"}
    except ComposioAPIError as e:
        # 记录日志并返回友好错误
        print(f"Composio API 错误：{e.message}")
        return {"success": False, "error": "通知服务暂时不可用"}