/ Каталог / Песочница / api-gateway-skill
● Сообщество maton-ai ⚡ Сразу

api-gateway-skill

автор maton-ai · maton-ai/api-gateway-skill

One API key unlocks Slack, HubSpot, Salesforce, Google Workspace, Shopify and more — Maton's managed auth gateway wrapped as a Claude skill.

Instead of registering OAuth apps with 8 different SaaS vendors, you get a single Maton API key and Claude can call all of them through the gateway. Maton handles token refresh, scopes, and per-vendor quirks; you focus on the workflow.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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

Pull today's HubSpot deals and post a brief to Slack

👤 Sales ops, founders running their own revenue reporting ⏱ ~15 min beginner

Когда использовать: You want a daily 'what moved in the pipeline' without logging into HubSpot.

Предварительные требования
  • Maton account and API key — Sign up at maton.ai, connect HubSpot and Slack under integrations
  • Skill installed — git clone https://github.com/maton-ai/api-gateway-skill ~/.claude/skills/api-gateway-skill
Поток
  1. Query HubSpot
    Use api-gateway-skill. Pull deals updated today with a stage change in HubSpot. Include owner, amount, new stage.✓ Скопировано
    → Structured list of deals with changes
  2. Format for Slack
    Summarize into a 5-line Slack message celebrating wins and flagging at-risk deals.✓ Скопировано
    → Slack-flavored markdown
  3. Post
    Post to #sales-daily.✓ Скопировано
    → Message posted; link returned

Итог: A daily brief posted without copy-paste between 3 tools.

Подводные камни
  • Overposting when the pipeline is quiet — Ask Claude to skip posting on days with zero stage changes

Export yesterday's Shopify orders to a Google Sheet

👤 E-commerce ops teams using spreadsheets for reporting ⏱ ~10 min beginner

Когда использовать: You want a daily running sheet without a Shopify app install.

Поток
  1. Fetch orders
    Use api-gateway-skill. Pull yesterday's Shopify orders with SKU, quantity, customer, country.✓ Скопировано
    → Order array
  2. Append to sheet
    Append as new rows to 'Orders 2026' sheet.✓ Скопировано
    → Row count returned

Итог: A self-populating order log.

Подводные камни
  • Rate limits during Black Friday — Paginate with Shopify cursors; Maton exposes them

Enrich Salesforce leads with recent Slack conversations

👤 AE / CS teams that discuss customers in Slack but report in SFDC ⏱ ~20 min intermediate

Когда использовать: You want customer context from multiple sources without swiveling.

Поток
  1. For a given lead, find Slack threads
    Use api-gateway-skill. Lead: ACME Corp. Find Slack messages in #cs-acme from the last 30 days mentioning them.✓ Скопировано
    → Threads with timestamps + snippets
  2. Summarize and write back
    Summarize into a 3-bullet note and append to the ACME account in Salesforce.✓ Скопировано
    → SFDC note created

Итог: Context lives in both places without manual copy.

Подводные камни
  • Private channels missed — Make sure Maton's Slack app is invited to the relevant channels

Комбинации

Сочетайте с другими MCP — эффект x10

api-gateway-skill + airtable

Sync between Maton-connected systems and your Airtable source of truth

Mirror HubSpot deals into the 'Pipeline' Airtable base.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
gateway_call vendor, endpoint, params Any cross-vendor operation 1 Maton API call
list_connections none Checking what's available before a workflow 1 call

Стоимость и лимиты

Во что обходится

Квота API
Per Maton plan — typically thousands of calls/day on paid tiers
Токенов на вызов
200–500 per vendor call
Деньги
Maton has a free tier; paid tiers scale with call volume
Совет
Batch reads where possible; each call counts.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Vary per vendor — scoped to what you connect
Хранение учётных данных: Single Maton API key in env var (e.g. MATON_API_KEY); vendor tokens stored server-side by Maton
Исходящий трафик: Maton's API, then to the connected vendors
Никогда не давайте: Admin scopes you don't need

Устранение неполадок

Частые ошибки и исправления

401 from gateway_call

Maton API key wrong or expired; regenerate in Maton dashboard

Проверить: curl -H "Authorization: Bearer $MATON_API_KEY" https://api.maton.ai/v1/connections
Vendor-specific error bubbles up

Maton passes vendor errors through. Check the vendor's docs for the error code.

Connection missing a scope

Reconnect the vendor in Maton UI and grant the needed scope

Альтернативы

api-gateway-skill в сравнении

АльтернативаКогда использоватьКомпромисс
Direct vendor MCPs (slack, hubspot, salesforce)You only need 1-2 vendorsManage OAuth yourself but no gateway dependency
Zapier / MakeNon-AI automation, point-and-clickNo LLM in the loop

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills