内容
# Composio for Cursor
Composio 让您连接并操作 **1000+ 应用**，例如 Google Workspace、Slack、GitHub、Notion、Linear、Jira、HubSpot 等，直接从您的代理（agent）开始，通过 [Composio](https://composio.dev) MCP 服务器。
Composio 处理 OAuth、权限和智能工具路由，并提供一个远程沙盒（sandbox）用于批量数据处理。
Composio 与任何代理框架（agent harness）兼容，例如 Claude Code、Codex、OpenClaw 和 Hermes。
## 您能做什么
除了单应用操作外，代理还可以：
- **运行跨应用工作流** - 例如，将最新的 GitHub PR 转换为 Linear 问题，并在 Slack 中宣布；从日历事件中草拟文档。
- **在远程沙盒中计算** - 聚合、解析和转换大型工具响应（例如，数百封邮件的发送者域名分布、工作日分解、去重/连接），而无需将所有内容拉入上下文。
- **按需连接应用** - 全面托管的 OAuth；代理为您提供身份验证链接，并等待其完成。
## 包含的内容
| 组件 | 目的 |
|---|---|
| `mcp.json` | 注册 Composio MCP 服务器 (`connect.composio.dev/mcp`)，暴露 7 个元工具。 |
| `skills/composio-mcp` | 教导代理搜索 → 连接 → 执行工作流和最佳实践。 |
| `skills/composio-activity-summary` | 为给定时间段生成跨应用的公司活动摘要（Slack、GitHub、Notion、Linear、Gmail 等）。 |
## 安装
### 将 MCP 服务器添加到 Cursor（一步到位）
[](https://cursor.com/en-US/install-mcp?name=composio&config=eyJ1cmwiOiJodHRwczovL2Nvbm45Y3QuY29tcG9zaW8uZGV2L21jcCJ9)
或者，在 **Cursor → 设置 → MCP** 中手动添加：
```json
{
"mcpServers": {
"composio": {
"url": "https://connect.composio.dev/mcp"
}
}
}
```
### 安装完整插件（MCP + 技能）
从 Cursor 插件市场：
```
/add-plugin composio
```
首次使用时，代理会引导您连接应用：它会返回 OAuth 链接，您授权后，连接即可用于所有未来请求。
### 本地测试
将仓库 symlink 到 Cursor 的本地插件，然后重新加载窗口（`Developer: Reload Window`）：
```bash
ln -sfn "$PWD" ~/.cursor/plugins/local/composio # remove with: rm ~/.cursor/plugins/local/composio
```
## 工作原理
插件暴露 7 个 `COMPOSIO_*` 元工具，而不是数千个单独的应用工具。代理：
1. **搜索** 使用 `COMPOSIO_SEARCH_TOOLS` 查找合适的工具。
2. **连接** 应用（如果需要）通过托管的 OAuth (`COMPOSIO_MANAGE_CONNECTIONS` → `COMPOSIO_WAIT_FOR_CONNECTIONS`)。
3. **执行** 一个或多个工具，使用 `COMPOSIO_MULTI_EXECUTE_TOOL`。
4. **处理** 远程沙盒中的大型/批量结果 (`COMPOSIO_REMOTE_WORKBENCH` / `COMPOSIO_REMOTE_BASH_TOOL`)。
参见 `skills/composio-mcp/SKILL.md` 以获取完整的元工具参考。
## 示例
每个查询都明确指出应用，这是技能所期望的 - 它保持工具搜索范围限定且运行可靠。
**单应用：**
```text
我的 Google 日历明天有什么安排？添加一个 12 点的午餐活动。
```
**跨应用工作流** （分诊 - 读取源写入）：
```text
执行以下操作：
1. 获取今日未读的 Gmail 邮件和 Slack 提及/私信
2. 将它们分类为行动项或信息
3. 发布摘要到名为“每日分诊”的新 Notion 页面
```
**并行工作流** （独立读取，分批处理）：
```text
并行搜索和执行：
- 获取我最近 10 封 Gmail 邮件
- 打开 Linear 问题
- 今日 Google 日历事件
删除个人信息后给我一个简洁的摘要。
```
**沙盒计算** （批量数据，不在聊天中）：
```text
获取我最近 20 封 Gmail 邮件，
- 查找促销/新闻稿发送者
- 按发送邮件数量排名，以便我可以手动取消订阅
使用 COMPOSIO_REMOTE_WORKBENCH。
```
## 许可证
MIT
