/ Directorio / Playground / api-gateway-skill
● Comunidad maton-ai ⚡ Instantáneo

api-gateway-skill

por maton-ai · maton-ai/api-gateway-skill

Una clave API desbloquea Slack, HubSpot, Salesforce, Google Workspace, Shopify y más — puerta de autenticación gestionada de Maton encapsulada como un Skill de Claude.

En lugar de registrar apps OAuth con 8 proveedores SaaS diferentes, obtienes una única clave API de Maton y Claude puede llamarlos a todos a través de la puerta de enlace. Maton gestiona la renovación de tokens, los permisos y las particularidades de cada proveedor; tú te enfocas en el flujo de trabajo.

Por qué usarlo

Características clave

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
  1. 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
  2. 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
  3. 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
  1. Obtener pedidos
    Usa api-gateway-skill. Extrae los pedidos de Shopify de ayer con SKU, cantidad, cliente, país.✓ Copiado
    → Array de pedidos
  2. 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
  1. 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
  2. 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

HerramientaEntradasCuándo llamarCoste
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

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

AlternativaCuándo usarlaContrapartida
MCPs de proveedores directos (slack, hubspot, salesforce)Solo necesitas 1-2 proveedoresGestiona OAuth tú mismo pero sin dependencia de puerta de enlace
Zapier / MakeAutomatización sin IA, punto y clicSin LLM en el flujo

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills