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

Por qué usarlo

Características clave

Una única clave API para 50+ APIs de SaaS
OAuth gestionado — sin registro de app por proveedor
Renovación de tokens manejada del lado del servidor
Formato de error unificado entre proveedores
Permisos con ámbito que puedes revocar centralmente

Demo en vivo

Cómo se ve en la práctica

api-gateway-skill.replay ▶ listo

0/0

Instalar

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

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la 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
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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
    }
  }
}

Mismo formato que Claude Desktop. Reinicia 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"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: api-gateway-skill

Extraer ofertas de HubSpot de hoy y publicar un resumen en Slack

👤 Operaciones de ventas, fundadores que gestionan su propio reporte de ingresos ⏱ ~15 min beginner

Cuándo usarlo: Deseas un reporte diario de 'qué se movió en el pipeline' sin iniciar sesión en HubSpot.

Requisitos previos

Cuenta de Maton y clave API — Regístrate en maton.ai, conecta HubSpot y Slack en integraciones
Skill instalado — git clone https://github.com/maton-ai/api-gateway-skill ~/.claude/skills/api-gateway-skill

Flujo

Consultar HubSpot

Usa api-gateway-skill. Extrae ofertas actualizadas hoy con cambio de fase en HubSpot. Incluye propietario, monto, nueva fase.✓ Copiado

→ Lista estructurada de ofertas con cambios
Formatear para Slack

Resume en un mensaje de Slack de 5 líneas celebrando ganancias y marcando ofertas en riesgo.✓ Copiado

→ Markdown con sabor Slack
Publicar

Publica en #sales-daily.✓ Copiado

→ Mensaje publicado; enlace devuelto

Resultado: Un resumen diario publicado sin copiar y pegar entre 3 herramientas.

Errores comunes

Publicar en exceso cuando el pipeline está tranquilo — Pídele a Claude que omita la publicación en días sin cambios de fase

Exportar pedidos de Shopify de ayer a una hoja de Google

👤 Equipos de operaciones de e-commerce que usan hojas de cálculo para reportes ⏱ ~10 min beginner

Cuándo usarlo: Deseas una hoja que se actualice diariamente sin instalar una app de Shopify.

Flujo

Obtener pedidos

Usa api-gateway-skill. Extrae los pedidos de Shopify de ayer con SKU, cantidad, cliente, país.✓ Copiado

→ Array de pedidos
Añadir a la hoja

Añade como filas nuevas a la hoja 'Orders 2026'.✓ Copiado

→ Número de filas devuelto

Resultado: Un registro de pedidos que se auto-rellena.

Errores comunes

Límites de velocidad durante el Black Friday — Pagina con cursores de Shopify; Maton los expone

Enriquecer leads de Salesforce con conversaciones recientes de Slack

👤 Equipos de AE/CS que discuten clientes en Slack pero reportan en SFDC ⏱ ~20 min intermediate

Cuándo usarlo: Deseas contexto de cliente de múltiples fuentes sin cambiar de ventana.

Flujo

Para un lead dado, encuentra threads de Slack

Usa api-gateway-skill. Lead: ACME Corp. Encuentra mensajes de Slack en #cs-acme de los últimos 30 días mencionándolos.✓ Copiado

→ Threads con marcas de tiempo + fragmentos
Resume y escribe de vuelta

Resume en una nota de 3 puntos y añade a la cuenta ACME en Salesforce.✓ Copiado

→ Nota de SFDC creada

Resultado: El contexto vive en ambos lugares sin copia manual.

Errores comunes

Canales privados omitidos — Asegúrate de que la app de Slack de Maton esté invitada a los canales relevantes

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

api-gateway-skill + airtable

Sincronizar entre sistemas conectados de Maton y tu fuente de verdad de Airtable

Espeja las ofertas de HubSpot en la base 'Pipeline' de Airtable.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
gateway_call	vendor, endpoint, params	Cualquier operación entre proveedores	1 llamada API de Maton
list_connections	ninguno	Verificar qué está disponible antes de un flujo de trabajo	1 llamada

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Por plan de Maton — típicamente miles de llamadas/día en planes pagos
Tokens por llamada: 200–500 por llamada de proveedor
Monetario: Maton tiene un nivel gratuito; los niveles pagos escalan con el volumen de llamadas
Consejo: Agrupa lecturas donde sea posible; cada llamada cuenta.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Varían por proveedor — limitados a lo que conectes

Almacenamiento de credenciales: Una única clave API de Maton en variable de entorno (p. ej. MATON_API_KEY); tokens del proveedor almacenados del lado del servidor por Maton

Salida de datos: API de Maton, luego a los proveedores conectados

No conceder nunca: Permisos de administrador que no necesitas

Estás confiando en Maton como intermediario OAuth. Revisa su documentación de seguridad y postura SOC2 antes de conectar sistemas de producción.
Rota la clave API de Maton periódicamente. Revoca conexiones de proveedores desde el panel de Maton cuando ya no las necesites.

Resolución de problemas

Errores comunes y soluciones

Error 401 desde gateway_call

Clave API de Maton incorrecta o expirada; regenera en el panel de Maton

Verificar: curl -H "Authorization: Bearer $MATON_API_KEY" https://api.maton.ai/v1/connections

Error específico del proveedor surge

Maton pasa los errores del proveedor. Revisa la documentación del proveedor para el código de error.

Falta un permiso en la conexión

Reconecta el proveedor en la interfaz de Maton y otorga el permiso necesario

Alternativas

api-gateway-skill vs otros

Alternativa	Cuándo usarla	Contrapartida
MCPs de proveedores directos (slack, hubspot, salesforce)	Solo necesitas 1-2 proveedores	Gestiona OAuth tú mismo pero sin dependencia de puerta de enlace
Zapier / Make	Automatización sin IA, punto y clic	Sin LLM en el flujo

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills