Conecta tus herramientas agénticas a Meteor

Cualquier herramienta que hable MCP — Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex 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 mcp add --transport http meteor \
  https://api.met.meteor.com.co/api/v1/mcp \
  --header "Authorization: Bearer met_live_tu_key"

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

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

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

[mcp_servers.meteor]
command = "npx"
args = ["-y", "mcp-remote", "https://api.met.meteor.com.co/api/v1/mcp", "--header", "Authorization: Bearer met_live_tu_key"]

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://api.met.meteor.com.co/api/v1/mcp'),
  { 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.

Descubrimiento

Si tu cliente resuelve servidores por dominio en vez de por URL fija, el descriptor está publicado:

curl https://developers.meteor.com.co/.well-known/mcp.json

Trae el endpoint, el transporte, cómo autenticar y la lista de tools. Se genera del catálogo real del servidor en cada build, así que no puede quedar desactualizado respecto de lo que el servidor expone de verdad.

Junto a él va server.json, el descriptor con el formato de los registros de MCP. Es el que sirve para que un agente encuentre Meteor sin conocer este dominio.

Capacidades

El catálogo son 34 tools sobre 15 dominios, y se filtra por los scopes de tu key: si la key no tiene el scope, la tool no aparece. Esta tabla se genera del catálogo real del servidor.

Es un subconjunto de la API REST, no su equivalente: cada tool llama al mismo service y declara el mismo scope que su endpoint, pero no todos los endpoints tienen tool. Lo que no esté aquí se hace por REST o por el SDK.

Si tu key es de partner

Una key de partner habla con otro endpoint, en el host de la API de Partners:

https://api.partners.meteor.com.co/mcp

Son dos servidores distintos y con qué key te autenticas decide cuál te sirve: una key de workspace habla con el de arriba, una de partner con este. Un workspace y una cartera de clientes no comparten permisos, así que tampoco comparten catálogo — y una key de workspace apuntando aquí recibe un catálogo vacío, no un error.

Son 13 tools, todas con el prefijo met_partner_. El partner sobre el que operan sale de tu key, nunca de un argumento.

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 tarea ejecutada 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.