用 Composio 给 AI 智能体一键接上 GitHub / Notion / Slack（1000+ 工具集成层）

Composio 有免费档（每月 2 万次工具调用），个人练手完全够用：

1. 打开 composio.dev 注册（GitHub / Google 登录）
2. 进入 Dashboard，左侧「Settings / API Keys」
3. 创建一个 API Key，形如 cmp-xxxx，复制保存
4. （可选）设置环境变量，方便后面用：
   export COMPOSIO_API_KEY="cmp-你的Key"

Composio 的核心是 Tool Router：一个 MCP Server，能跨所有 toolkit 搜索、认证、执行工具。用几行代码创建会话并拿到它的 MCP URL：

npm install @composio/core @ai-sdk/openai @ai-sdk/mcp

# 然后：
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
const { mcp } = await composio.create('your-user-id');
console.log(mcp.url);   // 这就是给 Agent 用的 MCP 端点

拿到 mcp.url 后，把它作为自定义 MCP Server 加进你的 Agent 客户端。以 Claude Desktop / Cursor 为例：

# 客户端 MCP 配置里加一项（JSON）
{
  "mcpServers": {
    "composio": {
      "url": "https://mcp.composio.dev/你的会话ID",
      "headers": { "x-api-key": "cmp-你的Key" }
    }
  }
}

# Cursor：Settings → MCP → Add → 填上面 URL
# Claude Desktop：config 里 mcpServers 段同上

第一次让 Agent 操作某个 App，需要你点头授权一次。Composio 会弹出官方 OAuth 流程，token 由它托管刷新，你的密码从不直接给 Agent：

# 在代码里触发连接（或直接对 Agent 说「连 Notion」）
const entity = await composio.getEntity('your-user-id');
const connection = await entity.initiateConnection('notion');
// 浏览器打开 connection.redirectUri 完成授权
// 之后 Agent 就能 create / update Notion 页面

# 或直接对 Agent 说：
"把这次对话的总结写成一页 Notion，放在我的工作区"

这是 Composio 官方最爱举的例子，也是最能体现价值的「跨 App 自动化」：

# 对 Agent 描述目标即可，工具调用由 Composio 路由执行
"监听 Slack 的 #bugs 频道，发现新 bug 就：
  1) 在 GitHub 建一个 Issue
  2) 在 Notion 的『Bug 日志』数据库写一条记录
  3) 在 Slack 原线程回一句『已建 Issue #123』"

# Agent 内部会自动：
#  search_composio_tools("github create issue")
#  search_composio_tools("notion create page")
#  带着你的授权 token 依次执行，全程你不用写一行集成代码

除了「你问它做」，还可以让外部事件自动触发：比如 GitHub 来了新 Issue、Slack 收到关键词消息，就自动拉起工作流。

# Composio 的 Triggers：订阅外部事件
# 例：每当 GitHub 新建 Issue，自动发 Slack 通知 + 写 Notion
# 在 Dashboard 或 SDK 里配置 trigger 即可，无需常驻轮询

# 多账号：工作/个人 Gmail 用 alias 区分
# 同一套工具层可绑定多个用户账户，Agent 调用时显式选择