Composio Claude Code 教學 2026:73K★ 一個指令直連 Slack/Notion/GitHub,78 個 SaaS 自動化完整指南
🔑 本文重點摘要
- Composio 是什麼:GitHub 73K★ 開源工具整合框架,讓 AI Agent(包含 Claude Code)直接呼叫 78 個 SaaS 工具
- 核心優勢:免手寫 OAuth、自動管理 token,5 分鐘完成 Claude Code ↔ GitHub/Slack/Notion 整合
- 與 MCP 的關係:Composio 提供 MCP server 模式,可直接掛載到 Claude Code 的 MCP 設定
- 適合誰:需要讓 Claude Code 執行「跨 SaaS 自動化」任務的開發者,例如 PR 通知、Issue 自動整理、文件同步
- 費用:免費層支援基本使用,付費方案從 $29/月起
一、為什麼 73K★ 的 Composio 在繁中社群幾乎沒人討論?
如果你在 GitHub 上追蹤 AI 工具趨勢,應該看過 Composio 的名字。2026 年 5 月,Composio 達到 73,400 顆星,成為 GitHub 上 Claude Code Skills 相關領域排名第一的開源專案。它的目標很清楚:讓任何 AI Agent 都能像使用本地函數一樣,直接呼叫 78 個 SaaS 工具。
然而,繁體中文的完整教學幾乎是零。大多數中文資料停留在「Composio 是什麼」的一兩行說明,沒有針對 Claude Code 用戶的完整整合教學。這篇文章要補上這個空白。
二、Composio 到底解決了什麼問題?
在沒有 Composio 之前,要讓 Claude Code 執行「把 GitHub Issue 自動整理成 Notion 文件」這種任務,你需要:
- 為 GitHub 寫 OAuth 2.0 流程(token 申請、刷新、儲存)
- 為 Notion 寫另一套 API 整合
- 自己管理兩組 API key 和 refresh token
- 寫工具函數,讓 Claude 知道「可以呼叫這些工具」
- 處理 rate limit、錯誤重試、權限不足等邊緣情況
每一步都是負擔。Composio 把這些全部打包好了。你只需要:
pip install composio-claude
composio login
composio add github
composio add notion
完成。剩下的 OAuth、token 管理、工具描述生成——Composio 全包。
三、支援的 78 個整合一覽
Composio 支援的工具涵蓋開發者日常工作的各個面向:
完整清單可以在 composio.dev/tools 查看。每個整合都附有標準化的工具描述,Claude 可以直接理解「這個工具能做什麼、需要什麼參數」。
四、5 步驟完成 Claude Code 整合
安裝 Composio Python SDK
pip install composio-claude composio-core
需要 Python 3.9+。如果你在使用 Claude Code,通常已有 Python 環境。
登入並取得 API Key
composio login
會開啟瀏覽器到 composio.dev 進行 OAuth 登入。完成後 API key 自動寫入 ~/.composio/config.json。
加入你需要的整合
# 加入 GitHub
composio add github
# 加入 Slack(需要 Slack workspace 管理員權限)
composio add slack
# 加入 Notion
composio add notion
# 查看已加入的整合
composio integrations
每個 composio add 會引導你完成該服務的 OAuth 授權。token 由 Composio 雲端代為管理,你不需要自己維護。
在 Claude Code 中初始化 Composio 工具
import anthropic
from composio_claude import ComposioToolSet, App
client = anthropic.Anthropic()
toolset = ComposioToolSet()
# 取得 GitHub 相關的所有工具
tools = toolset.get_tools(apps=[App.GITHUB])
# 也可以混合多個 App
tools = toolset.get_tools(apps=[App.GITHUB, App.SLACK, App.NOTION])
讓 Claude 執行跨 SaaS 任務
response = client.messages.create(
model="claude-sonnet-5-20260701", # 或任何 Claude 模型
max_tokens=4096,
tools=tools,
messages=[{
"role": "user",
"content": (
"請掃描 composio-dev/composio 這個 repo 的所有 open issues,"
"把標有 'bug' 標籤的 issues 整理成一份清單,"
"然後在我的 Notion workspace 新建一個頁面叫做 'Bug Tracker 2026-08-31',"
"把清單貼上去。"
)
}]
)
# Composio 自動處理工具呼叫循環
result = toolset.handle_tool_calls(client, response, messages=[...])
Claude 會自動決定要呼叫哪些工具、以什麼順序、帶什麼參數。你不需要手動管理工具呼叫循環。
五、掛載 MCP 模式(Claude Code 原生整合)
如果你偏好在 Claude Code 的 .claude/settings.json 中配置 MCP server,Composio 提供了原生 MCP 支援:
# 啟動 Composio MCP server
composio mcp start --apps github,slack,notion --port 8080
然後在 ~/.claude/settings.json 加入:
{
"mcpServers": {
"composio": {
"command": "composio",
"args": ["mcp", "serve", "--apps", "github,slack,notion"],
"env": {
"COMPOSIO_API_KEY": "your_api_key_here"
}
}
}
}
這樣 Claude Code 就可以在對話中直接使用 /tool composio 呼叫任何整合,不需要在程式碼中顯式初始化。對於喜歡 CLI 工作流程的開發者,這是更乾淨的方式。
六、四個台灣開發者實戰場景
場景一:GitHub PR 自動通知 Slack
每當有新 PR 被開啟,自動在 Slack 頻道發一則摘要,包含 PR 標題、作者、變更的檔案清單。
tools = toolset.get_tools(apps=[App.GITHUB, App.SLACK])
prompt = """
監聽 my-org/my-repo 的新 Pull Requests。
對每個新 PR,在 #code-review Slack 頻道發訊息:
格式:「🔔 新 PR:{title} by @{author} - {files_changed} 個檔案變更」
"""
場景二:每日 Issue 報告寄到 Gmail
每天早上 9 點,把昨天新開的所有 GitHub Issues 彙整成報告,寄給 PM 的 Gmail。
tools = toolset.get_tools(apps=[App.GITHUB, App.GMAIL])
prompt = """
找出 my-org/my-repo 過去 24 小時內新開的所有 Issues。
按照 Priority label 排序,生成 HTML 格式報告,
寄送到 pm@company.com,主旨:「Daily Issue Report - {date}」
"""
場景三:把 Notion 需求文件自動轉成 Linear Ticket
PM 在 Notion 寫好需求文件後,讓 Claude + Composio 自動解析並建立對應的 Linear tickets。
tools = toolset.get_tools(apps=[App.NOTION, App.LINEAR])
prompt = """
讀取 Notion 頁面 ID: {page_id} 的內容。
識別所有「功能需求」段落(以 ## 開頭)。
在 Linear 的 Engineering 團隊為每個需求建立一個 ticket,
設定優先級 Medium,assignee 留空。
"""
場景四:Stripe 付款異常自動回報
當 Stripe 有失敗付款時,自動在 Slack 發警告並在 Airtable 建一筆記錄。
tools = toolset.get_tools(apps=[App.STRIPE, App.SLACK, App.AIRTABLE])
prompt = """
查詢過去 1 小時內 Stripe 上狀態為 failed 的 payment intents。
對每筆失敗付款:
1. 在 #payments-alert Slack 頻道發送警告
2. 在 Airtable 'Failed Payments' 表格建一筆記錄
欄位:payment_id, amount, currency, reason, timestamp
"""
七、Composio vs 其他工具整合方案比較
| 方案 | 設定難度 | 整合數量 | MCP 支援 | 免費層 | 適合場景 |
|---|---|---|---|---|---|
| Composio 推薦 | 低(5分鐘) | 78 個 | ✅ 原生 | ✅ 有 | 多 SaaS 自動化 |
| 手寫 API 整合 | 高(每個需個別實作) | 無限制 | 自行實作 | ✅ 有 | 高度客製需求 |
| n8n | 中 | 500+ | ⚠️ 間接 | ✅ 自託管 | 視覺化工作流 |
| Zapier | 低 | 6,000+ | ❌ | ⚠️ 限量 | 非技術用戶 |
| LangChain Tools | 中 | ~30 | ⚠️ 部分 | ✅ 有 | LangChain 生態 |
Composio 的優勢在於「與 AI Agent 的整合深度」——它不是讓人類透過 UI 操作工具,而是設計給 AI 直接呼叫的。工具描述格式標準化,Claude 可以直接理解每個工具的功能和參數,不需要額外 prompt 工程。
八、費用和帳號設定
| 方案 | 費用 | 每月工具呼叫次數 | 整合數量 | 適合 |
|---|---|---|---|---|
| Free | $0 | 1,000 次 | 全部 78 個 | 個人專案、測試 |
| Starter | $29/月 | 10,000 次 | 全部 78 個 | 個人開發者 |
| Pro | $99/月 | 100,000 次 | 全部 78 個 + 優先支援 | 小型團隊 |
| Enterprise | 議價 | 無限制 | 全部 + 自訂整合 | 企業 |
免費層的 1,000 次/月對測試和輕量使用完全夠用。如果你正在建立 SaaS 自動化產品,Starter 方案的 10,000 次通常可以支撐早期用戶。
如果你需要在 VPS 上部署 Composio MCP server 以降低延遲,DigitalOcean 的 Droplet 是成本效益最高的選擇,新帳戶有 $200 免費額度。
九、Composio 在 Claude Code Agentic 工作流中的位置
如果你已經在用這些工具,Composio 可以很自然地整合進去:
- crush:終端機 agentic coding,可搭配 Composio MCP 讓 crush 呼叫外部 SaaS
- ponytail:原生 API 優先索引,與 Composio 互補——ponytail 優化 Claude 的 API 呼叫效率,Composio 處理外部 SaaS 整合
- OpenViking:Agent memory 工具,搭配 Composio 可以讓 Claude 記住「上次通知了哪些 Slack 訊息」
這三個工具加上 Composio,就構成了一個完整的 Claude Code agentic 工具鏈:ponytail(省 token)+ OpenViking(記憶)+ Composio(外部整合)+ crush(終端機執行環境)。
🛠️ 需要雲端環境跑 Composio Server?
DigitalOcean Droplet $6/月起,適合跑 Composio MCP server 和 Claude Code 自動化腳本。
DigitalOcean 免費 $200 → DataCamp AI 課程 →十、FAQ — 常見問題
十一、結論:Composio 讓 Claude Code 真正「跨出去」
Composio 解決的核心問題是:AI Agent 不應該被困在對話框裡。它應該能夠直接存取你的 GitHub、你的 Slack、你的 Notion,完成橫跨多個系統的真實任務。
73K★ 不是一個偶然的數字。它反映了開發者社群對「AI Agent + SaaS 整合」這個方向的真實需求。繁中社群現在可以透過這篇教學,在 5 分鐘內完成第一個 Claude Code + Composio 整合。
下一步建議:先從最常用的工具開始(GitHub + Slack 是最常見的起點),確認基本流程能跑通後,再逐步加入 Notion、Linear 等工具。Composio 的官方文件有完整的範例,搭配本文的教學,台灣開發者應該可以快速上手。
🎓 想系統學習 AI Agent 開發?
DataCamp 提供完整的 AI/ML 課程,從 Python 基礎到 LLM API 整合和 Agent 架構設計,都有中文字幕支援。
DataCamp 免費試用 → Claude Code 技巧包 →本文包含聯盟行銷連結。透過連結購買,我們可能獲得少量佣金,不影響您的費用,也不影響本文評測立場。最後更新:2026-08-31。