api-gateway-skill MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Single API key for 50+ SaaS APIs
Managed OAuth — no per-vendor app registration
Token refresh handled server-side
Unified error shape across vendors
Scoped permissions you can revoke centrally

Demo ao vivo

Como fica na prática

api-gateway-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "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
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.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"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um 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"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: 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

Quando usar: You want a daily 'what moved in the pipeline' without logging into HubSpot.

Pré-requisitos

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

Fluxo

Query HubSpot

Use api-gateway-skill. Pull deals updated today with a stage change in HubSpot. Include owner, amount, new stage.✓ Copiado

→ Structured list of deals with changes
Format for Slack

Summarize into a 5-line Slack message celebrating wins and flagging at-risk deals.✓ Copiado

→ Slack-flavored markdown
Post

Post to #sales-daily.✓ Copiado

→ Message posted; link returned

Resultado: A daily brief posted without copy-paste between 3 tools.

Armadilhas

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

Quando usar: You want a daily running sheet without a Shopify app install.

Fluxo

Fetch orders

Use api-gateway-skill. Pull yesterday's Shopify orders with SKU, quantity, customer, country.✓ Copiado

→ Order array
Append to sheet

Append as new rows to 'Orders 2026' sheet.✓ Copiado

→ Row count returned

Resultado: A self-populating order log.

Armadilhas

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

Quando usar: You want customer context from multiple sources without swiveling.

Fluxo

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.✓ Copiado

→ Threads with timestamps + snippets
Summarize and write back

Summarize into a 3-bullet note and append to the ACME account in Salesforce.✓ Copiado

→ SFDC note created

Resultado: Context lives in both places without manual copy.

Armadilhas

Private channels missed — Make sure Maton's Slack app is invited to the relevant channels

Combinações

Combine com outros MCPs para 10× de alavancagem

api-gateway-skill + airtable

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

Mirror HubSpot deals into the 'Pipeline' Airtable base.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
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

Custo e limites

O que custa rodar

Cota de API: Per Maton plan — typically thousands of calls/day on paid tiers
Tokens por chamada: 200–500 per vendor call
Monetário: Maton has a free tier; paid tiers scale with call volume
Dica: Batch reads where possible; each call counts.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Vary per vendor — scoped to what you connect

Armazenamento de credenciais: Single Maton API key in env var (e.g. MATON_API_KEY); vendor tokens stored server-side by Maton

Saída de dados: Maton's API, then to the connected vendors

Nunca conceda: Admin scopes you don't need

You're trusting Maton as an OAuth broker. Review their security docs and SOC2 posture before connecting production systems.
Rotate the Maton API key periodically. Revoke vendor connections from the Maton dashboard when no longer needed.

Solução de problemas

Erros comuns e correções

401 from gateway_call

Maton API key wrong or expired; regenerate in Maton dashboard

Verificar: 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

Alternativas

api-gateway-skill vs. outros

Alternativa	Quando usar	Troca
Direct vendor MCPs (slack, hubspot, salesforce)	You only need 1-2 vendors	Manage OAuth yourself but no gateway dependency
Zapier / Make	Non-AI automation, point-and-click	No LLM in the loop

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills