SuperAPI AI 工具集

connect-apps

办公与效率

查看项目

更新于 10-15 14:11

技能介绍

Connect Apps 是一个将 Claude 连接到外部应用的技能,基于 Composio CLI 实现。它的核心价值在于让 Claude 能够真正执行操作,例如发送邮件、创建 issue、发布消息,而不仅仅是生成关于这些操作的文本。该技能支持 1000+ 应用,覆盖邮件、聊天、开发、文档、数据等多个类别。

用途

当用户希望 Claude 发送邮件、创建 issue、发布消息,或跨多个应用执行实际操作时,可以使用此技能。它通过 Composio CLI 将 Claude 与外部应用打通,使对话中的指令能够转化为真实的应用动作。

主要能力

  • 连接 1000+ 应用,包括:
    • 邮件:Gmail、Outlook、SendGrid
    • 聊天:Slack、Discord、Teams、Telegram
    • 开发:GitHub、GitLab、Jira、Linear
    • 文档:Notion、Google Docs、Confluence
    • 数据:Sheets、Airtable、PostgreSQL
  • 支持执行具体动作,例如:
    • 发送邮件:composio execute GMAIL_SEND_EMAIL
    • 创建 GitHub issue:composio execute GITHUB_CREATE_ISSUE
    • 发布 Slack 消息:composio execute SLACK_SEND_MESSAGE
    • 创建 Notion 页面:composio execute NOTION_CREATE_PAGE
  • 支持工具发现、参数检查、并行执行、多步骤工作流和原始 API 调用。

使用方式

快速开始

第一步:安装 Composio CLI

curl -fsSL https://composio.dev/install | bash

第二步:登录

composio login composio whoami

该命令会打开浏览器进行认证,然后提示选择默认组织和项目。在脚本中可使用 -y 跳过提示。

第三步:链接所需应用

composio link gmail composio link slack composio link github

每个命令会引导完成一次 OAuth 授权,之后连接会持久保存。

第四步:试用

composio execute GMAIL_SEND_EMAIL -d '{ "recipient_email": "YOUR_EMAIL@example.com", "subject": "Composio test", "body": "Hello from the CLI" }'

如果邮件成功到达,说明连接已建立。

核心工作流

  • 已知工具 slug:composio execute <SLUG> -d '{...}'
  • 不知道 slug:composio search "what you want"
  • 需要输入参数:composio execute <SLUG> --get-schema 或 --dry-run
  • 尚未连接:composio link <toolkit> 后重试
  • 多步骤任务:使用 composio run 编写 JS/TS 工作流,或使用 composio proxy 发起原始 API 调用

常用命令

发现工具:

composio search "create a github issue" composio tools list gmail composio tools info GITHUB_CREATE_ISSUE

执行前检查或试运行:

composio execute GITHUB_CREATE_ISSUE --get-schema composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

并行执行:

composio execute --parallel
GMAIL_FETCH_EMAILS -d '{"max_results": 2}'
GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

多步骤工作流:

composio run ' const issue = await execute("GITHUB_CREATE_ISSUE", { owner: "acme", repo: "app", title: "Bug", body: "..." }); console.log(issue); '

无专用工具时的原始 API 调用:

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail

配置

环境变量:

  • COMPOSIO_API_KEY:用于非交互式使用的认证凭据
  • COMPOSIO_BASE_URL:自定义 API 端点
  • COMPOSIO_SESSION_DIR:覆盖产物存储位置
  • COMPOSIO_DISABLE_TELEMETRY=true:选择退出遥测

全局标志:--log-level <all|trace|debug|info|warning|error|fatal|none>、--help。

故障排查

  • 未登录:运行 composio login
  • 提示需要连接某工具包:运行 composio link <toolkit>
  • 未知 slug:运行 composio search "<goal>" 或 composio tools list <toolkit>
  • 输入参数错误:先运行 composio execute <SLUG> --get-schema,再运行 --dry-run
  • 动作失败:检查目标应用中的权限

完整参考文档:docs.composio.dev/docs/cli

适用场景

适用于需要让 Claude 跨多个外部应用执行真实操作的场景,例如自动发送邮件、在 GitHub 上创建 issue、在 Slack 中发布通知、将会议记录写入 Notion 等。也适合需要串联多个应用步骤的自动化工作流。

限制

使用前需要安装 Composio CLI 并完成登录和 OAuth 授权。部分操作可能受目标应用的权限限制。关于收费、价格、平台支持范围等具体信息,资料中暂未提供。