Model Context Protocol

Conecta tus herramientas agénticas a Meteor

Cualquier herramienta que hable MCP — Claude Code, Claude Desktop, Cursor, Windsurf, Cline o tu propio agente — se conecta directo a Meteor y opera tu workspace: ejecuta Mets, gestiona el CRM, dispara tareas y más. La misma superficie de la API, expuesta como herramientas.

Introducción

El Model Context Protocol es un estándar abierto para que los agentes de IA descubran y usen herramientas externas de forma segura. El servidor MCP de Meteor es remoto y se autentica con tu API key met_ — la misma que usas en la API REST. Cualquier cliente MCP puede conectarse; abajo está la config de los más comunes y de un agente propio.

El SDK y la API REST son para cuando tú escribes el código. El servidor MCP es para cuando un agente opera Meteor por su cuenta.

Conectar un cliente

Todos los clientes apuntan al mismo endpoint remoto y pasan tu key en el header Authorization. Usa una key de test (met_test_) mientras pruebas.

Claude Code

Un comando desde la terminal:

claude mcp add --transport http meteor \
  https://mcp.meteor.com.co \
  --header "Authorization: Bearer met_live_tu_key"

Claude Desktop

En claude_desktop_config.json:

{
  "mcpServers": {
    "meteor": {
      "url": "https://mcp.meteor.com.co",
      "headers": { "Authorization": "Bearer met_live_tu_key" }
    }
  }
}

Cursor

En .cursor/mcp.json (del proyecto) o el global:

{
  "mcpServers": {
    "meteor": {
      "url": "https://mcp.meteor.com.co",
      "headers": { "Authorization": "Bearer met_live_tu_key" }
    }
  }
}

Windsurf

En ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "meteor": {
      "serverUrl": "https://mcp.meteor.com.co",
      "headers": { "Authorization": "Bearer met_live_tu_key" }
    }
  }
}

Cline (VS Code)

Desde el panel de MCP de Cline, agrega un servidor remoto con la URL y el header de autenticación — misma forma que arriba.

Otros clientes MCP

Cualquier cliente compatible con MCP (transport HTTP/SSE) sirve. La receta es siempre la misma: URL del servidor + header Authorization: Bearer met_….

Tu propio agente

Si construyes tu propio agente, conéctalo con un cliente MCP programático (por ejemplo, @modelcontextprotocol/sdk) y dale a tu modelo las tools de Meteor:

import { Client } from '@modelcontextprotocol/sdk/client';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp';

const client = new Client({ name: 'mi-agente', version: '1.0.0' });
await client.connect(new StreamableHTTPClientTransport(
  new URL('https://mcp.meteor.com.co'),
  { requestInit: { headers: { Authorization: `Bearer ${process.env.MET_API_KEY}` } } },
));

const { tools } = await client.listTools();   // las tools de Meteor, según tus scopes
// pasas `tools` a tu modelo y ejecutas client.callTool(...) cuando el modelo lo pida

Así tu agente descubre y ejecuta las capacidades de Meteor sin que tú cablees cada endpoint a mano.

Capacidades

Cada dominio público se expone como un grupo de tools, filtradas por los scopes de tu key. Si la key no tiene el scope, la tool no aparece.

Dominio	Ejemplos de tools	Scope
Runs	ejecutar un Met, leer un run	`runs:execute` · `runs:read`
Agents	listar y configurar Mets	`agents:read` · `agents:write`
Contactos	crear contacto, mandar mensaje, etiquetar	`contacts:read` · `contacts:write`
Integraciones	ejecutar tools de conectores MCP	`integrations:*`
Tareas	ejecutar tareas agénticas	`tasks:read` · `tasks:write`
Datos	colecciones e ítems	`collections:` · `items:`
Webhooks	gestionar webhooks entrantes	`webhooks:manage`
Facturación	consultar plan y consumo	`billing:read`

Es la misma superficie que la Referencia de la API: una fuente de verdad, dos formas de consumirla.

Seguridad

La key define el workspace y los scopes: el agente solo ve y ejecuta lo permitido.
Las credenciales de terceros (de tus integraciones) nunca se exponen al agente — solo el resultado de las tools.
Cada ejecución debita Energía y queda auditada, igual que en la API REST.
Con una key de test (met_test_) el agente prueba sin costo ni efectos reales.

¿Prefieres escribir el código tú? Empieza por las Guías y el quickstart del SDK.