Composio Claude Code 教學 2026:73K★ 一個指令直連 Slack/Notion/GitHub,78 個 SaaS 自動化完整指南

作者:AutoDev AI | 發布:2026-08-31 | 字數:約 2,400 字 | 閱讀時間:約 10 分鐘

🔑 本文重點摘要

一、為什麼 73K★ 的 Composio 在繁中社群幾乎沒人討論?

如果你在 GitHub 上追蹤 AI 工具趨勢,應該看過 Composio 的名字。2026 年 5 月,Composio 達到 73,400 顆星,成為 GitHub 上 Claude Code Skills 相關領域排名第一的開源專案。它的目標很清楚:讓任何 AI Agent 都能像使用本地函數一樣,直接呼叫 78 個 SaaS 工具。

然而,繁體中文的完整教學幾乎是零。大多數中文資料停留在「Composio 是什麼」的一兩行說明,沒有針對 Claude Code 用戶的完整整合教學。這篇文章要補上這個空白。

73K★
GitHub Stars(2026-05)
78
支援的 SaaS 整合
5 分鐘
完成第一個整合
MIT
開源授權

二、Composio 到底解決了什麼問題?

在沒有 Composio 之前,要讓 Claude Code 執行「把 GitHub Issue 自動整理成 Notion 文件」這種任務,你需要:

  1. 為 GitHub 寫 OAuth 2.0 流程(token 申請、刷新、儲存)
  2. 為 Notion 寫另一套 API 整合
  3. 自己管理兩組 API key 和 refresh token
  4. 寫工具函數,讓 Claude 知道「可以呼叫這些工具」
  5. 處理 rate limit、錯誤重試、權限不足等邊緣情況

每一步都是負擔。Composio 把這些全部打包好了。你只需要:

pip install composio-claude
composio login
composio add github
composio add notion

完成。剩下的 OAuth、token 管理、工具描述生成——Composio 全包。

三、支援的 78 個整合一覽

Composio 支援的工具涵蓋開發者日常工作的各個面向:

🐙GitHub
💬Slack
📝Notion
📧Gmail
📅Google Calendar
📊Google Sheets
🗂️Google Drive
🎯Linear
Jira
🔗Airtable
📦AWS S3
🗄️PostgreSQL
📮Mailchimp
💳Stripe
🤝HubSpot
+ 63個更多

完整清單可以在 composio.dev/tools 查看。每個整合都附有標準化的工具描述,Claude 可以直接理解「這個工具能做什麼、需要什麼參數」。

四、5 步驟完成 Claude Code 整合

Step 1

安裝 Composio Python SDK

pip install composio-claude composio-core

需要 Python 3.9+。如果你在使用 Claude Code,通常已有 Python 環境。

Step 2

登入並取得 API Key

composio login

會開啟瀏覽器到 composio.dev 進行 OAuth 登入。完成後 API key 自動寫入 ~/.composio/config.json

Step 3

加入你需要的整合

# 加入 GitHub
composio add github

# 加入 Slack(需要 Slack workspace 管理員權限)
composio add slack

# 加入 Notion
composio add notion

# 查看已加入的整合
composio integrations

每個 composio add 會引導你完成該服務的 OAuth 授權。token 由 Composio 雲端代為管理,你不需要自己維護。

Step 4

在 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])
Step 5

讓 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 可以很自然地整合進去:

這三個工具加上 Composio,就構成了一個完整的 Claude Code agentic 工具鏈:ponytail(省 token)+ OpenViking(記憶)+ Composio(外部整合)+ crush(終端機執行環境)。

🛠️ 需要雲端環境跑 Composio Server?

DigitalOcean Droplet $6/月起,適合跑 Composio MCP server 和 Claude Code 自動化腳本。

DigitalOcean 免費 $200 → DataCamp AI 課程 →

十、FAQ — 常見問題

Q1:Composio 需要把我的 OAuth token 存在他們的伺服器嗎?
是的,預設情況下 Composio 雲端代為管理 token。這是他們的商業模式——幫你處理 token 刷新和安全儲存。如果你有資安顧慮,可以選擇自託管方案(Open Source 版本,需自行部署)。
Q2:可以同時在多個 Claude 工作階段中使用同一組 Composio 整合嗎?
可以。Composio 的 entity(用戶身份)可以在多個 session 共享,適合多 agent 並行場景。
Q3:Composio 支援 Claude Fable 5 的 1M context 嗎?
支援。Composio 的工具呼叫是標準的 Anthropic API 格式,任何 Claude 模型都可以搭配使用,包括 Fable 5。
Q4:78 個整合夠用嗎?有些工具我用的沒有怎麼辦?
Composio 提供 Custom Tools API,讓你加入任何 REST API 作為自定義工具。定義好 endpoint、參數和描述,Claude 就可以直接呼叫。
Q5:Composio 的免費層有什麼限制?
免費層限制每月 1,000 次工具呼叫,整合數量不受限(所有 78 個都可以用)。對個人專案和測試用途完全足夠。超過後會收到提醒,不會直接中斷服務。
Q6:n8n 用戶有必要換成 Composio 嗎?
不需要「換」,而是看場景。n8n 適合視覺化工作流設計,適合非技術用戶或流程複雜的場景。Composio 適合程式碼優先、需要讓 AI Agent 動態決策工具呼叫順序的場景。兩者可以共存。

十一、結論: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。