/ 目錄 / 演練場 / api-gateway-skill
● 社群 maton-ai ⚡ 即開即用

api-gateway-skill

作者 maton-ai · maton-ai/api-gateway-skill

一組 API 金鑰即可串接 Slack、HubSpot、Salesforce、Google Workspace、Shopify 等服務——Maton 的受管授權閘道,以 Claude skill 形式封裝。

不需要分別向 8 個 SaaS 廠商註冊 OAuth 應用程式,只要一組 Maton API 金鑰,Claude 就能透過閘道呼叫所有服務。Maton 負責處理權杖更新、授權範圍與各廠商的差異;你只需專注在工作流程本身。

為什麼要用

核心特性

即時演示

實際使用效果

api-gateway-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "api-gateway-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/maton-ai/api-gateway-skill",
        "~/.claude/skills/api-gateway-skill"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "api-gateway-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/maton-ai/api-gateway-skill",
        "~/.claude/skills/api-gateway-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "api-gateway-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/maton-ai/api-gateway-skill",
        "~/.claude/skills/api-gateway-skill"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "api-gateway-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/maton-ai/api-gateway-skill",
        "~/.claude/skills/api-gateway-skill"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "api-gateway-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/maton-ai/api-gateway-skill",
        "~/.claude/skills/api-gateway-skill"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "api-gateway-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/maton-ai/api-gateway-skill",
          "~/.claude/skills/api-gateway-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add api-gateway-skill -- git clone https://github.com/maton-ai/api-gateway-skill ~/.claude/skills/api-gateway-skill

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: api-gateway-skill

拉取今日 HubSpot 商機並發送摘要到 Slack

👤 銷售營運人員、自行追蹤營收報告的創辦人 ⏱ ~15 min beginner

何時使用: 你想每天掌握「pipeline 有什麼進展」,卻不想登入 HubSpot。

前置條件
  • Maton 帳號與 API 金鑰 — 前往 maton.ai 註冊,並在整合設定中連接 HubSpot 與 Slack
  • 已安裝 Skill — git clone https://github.com/maton-ai/api-gateway-skill ~/.claude/skills/api-gateway-skill
步驟
  1. 查詢 HubSpot
    Use api-gateway-skill. Pull deals updated today with a stage change in HubSpot. Include owner, amount, new stage.✓ 已複製
    → 結構化的商機異動清單
  2. 格式化為 Slack 訊息
    Summarize into a 5-line Slack message celebrating wins and flagging at-risk deals.✓ 已複製
    → Slack 風格的 Markdown 內容
  3. 發送訊息
    Post to #sales-daily.✓ 已複製
    → 訊息已發送;回傳訊息連結

結果: 每日摘要自動發送,無需在三個工具之間手動複製貼上。

注意事項
  • pipeline 無動靜時重複發送空訊息 — 請 Claude 在當日無階段變更時略過發送

將昨日 Shopify 訂單匯出至 Google 試算表

👤 使用試算表產出報表的電商營運團隊 ⏱ ~10 min beginner

何時使用: 你想要每日自動更新的訂單記錄,又不想安裝 Shopify 應用程式。

步驟
  1. 抓取訂單
    Use api-gateway-skill. Pull yesterday's Shopify orders with SKU, quantity, customer, country.✓ 已複製
    → 訂單陣列
  2. 新增至試算表
    Append as new rows to 'Orders 2026' sheet.✓ 已複製
    → 回傳新增的列數

結果: 自動累積的訂單記錄表。

注意事項
  • 黑色星期五期間觸發速率限制 — 使用 Shopify cursors 進行分頁;Maton 已將其公開

以近期 Slack 對話內容豐富 Salesforce 潛在客戶資料

👤 在 Slack 討論客戶、在 SFDC 記錄報告的客戶主管/客戶成功團隊 ⏱ ~20 min intermediate

何時使用: 你想整合多個來源的客戶背景資訊,不想在不同工具間來回切換。

步驟
  1. 針對指定潛在客戶搜尋 Slack 討論串
    Use api-gateway-skill. Lead: ACME Corp. Find Slack messages in #cs-acme from the last 30 days mentioning them.✓ 已複製
    → 含時間戳記與片段內容的討論串
  2. 摘要並回寫
    Summarize into a 3-bullet note and append to the ACME account in Salesforce.✓ 已複製
    → SFDC 備註已建立

結果: 背景資訊同步存在兩個系統,無需手動複製。

注意事項
  • 遺漏私人頻道的訊息 — 確認 Maton 的 Slack 應用程式已被邀請加入相關頻道

組合

與其他 MCP 搭配,撬動十倍槓桿

api-gateway-skill + airtable

在 Maton 已連接的系統與 Airtable 主資料來源之間進行同步

Mirror HubSpot deals into the 'Pipeline' Airtable base.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
gateway_call vendor, endpoint, params 任何跨廠商操作 1 Maton API call
list_connections none 在執行工作流程前確認已連接的服務 1 call

成本與限制

運行它的成本

API 配額
依 Maton 方案而定——付費方案通常每日可呼叫數千次
每次呼叫 Token 數
200–500 per vendor call
費用
Maton 提供免費方案;付費方案依呼叫量計費
提示
盡量批次讀取;每次呼叫都會計入用量。

安全

權限、密鑰、影響範圍

最小權限: Vary per vendor — scoped to what you connect
憑證儲存: 單一 Maton API 金鑰存於環境變數(例如 MATON_API_KEY);廠商權杖由 Maton 儲存於伺服器端
資料出站: 流經 Maton API,再傳送至各連接的廠商
切勿授予: Admin scopes you don't need

故障排查

常見錯誤與修復

401 from gateway_call

Maton API 金鑰錯誤或已過期;請在 Maton 控制台重新產生

驗證: curl -H "Authorization: Bearer $MATON_API_KEY" https://api.maton.ai/v1/connections
Vendor-specific error bubbles up

Maton 會直接傳遞廠商回傳的錯誤。請查閱該廠商的文件以了解對應的錯誤代碼。

Connection missing a scope

在 Maton UI 重新連接該廠商,並授予所需的授權範圍

替代方案

api-gateway-skill 對比其他方案

替代方案何時用它替代權衡
Direct vendor MCPs (slack, hubspot, salesforce)你只需要串接 1–2 個廠商需自行管理 OAuth,但無閘道依賴
Zapier / Make非 AI 自動化、點選式設定的情境流程中不涉及 LLM

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills