Servidor MCP

¿Qué es un servidor MCP?

MCP es un protocolo abierto que estandariza cómo las aplicaciones le pasan contexto a los LLMs. Entre otros beneficios, le da a los LLMs herramientas para actuar en tu nombre.

¿Qué puede hacer el servidor MCP de Commet?

El servidor MCP de Commet le da a tu agente de AI acceso nativo a toda la plataforma Commet a través de una sola integración. Puedes gestionar todos los aspectos de tu infraestructura de cobros y pagos usando lenguaje natural.

Organización — ver la organización live o sandbox fijada a la conexión
API de Commet — usar todas las operaciones del documento OpenAPI público actual
Docs — buscar en la documentación viva de Commet

Como ejemplo, puedes usarlo para armar un setup completo de cobros, gestionar planes y features, inspeccionar suscripciones de clientes o revisar recibos y datos de uso.

Prerrequisitos

El endpoint de MCP es el mismo para datos sandbox y live:

https://commet.co/mcp/v2

OAuth abre Commet en el navegador y te pide elegir una organización para la conexión. La conexión queda fijada a esa organización aunque después cambies la organización activa en el dashboard; para elegir otra hay que reconectar. La autenticación con API key usa exactamente la organización sandbox o live que creó la key. Por ahora OAuth expone las mismas herramientas de API a owners, admins y members. Para usarlo, necesitas:

Crear una cuenta de Commet
Tener un cliente compatible con MCP (Cursor, Claude Code, Claude Desktop, etc.)

Los clientes con navegador pueden usar OAuth sin API key. Si tu cliente corre en CI, en un servidor o en un entorno donde no se puede abrir el navegador, pasa una API key de Commet en el header x-api-key.

Cambia a una organización sandbox cuando experimentes o configures cobros por primera vez. Las operaciones sobre una organización live afectan a clientes reales de inmediato.

Cómo usar el servidor MCP

Elige tu cliente preferido abajo.

Abre el command palette y elige “Cursor Settings” > “MCP” > “Add new global MCP server”.

{
  "mcpServers": {
    "commet": {
      "url": "https://commet.co/mcp/v2"
    }
  }
}

claude mcp add --transport http commet https://commet.co/mcp/v2

Abre la configuración de Claude Desktop > pestaña “Developer” > “Edit Config”.

{
  "mcpServers": {
    "commet": {
      "url": "https://commet.co/mcp/v2"
    }
  }
}

codex mcp add commet --url https://commet.co/mcp/v2

El comando abre el navegador para autenticación OAuth. Una vez completado, verifica con:

codex mcp list

Agrega lo siguiente a tu settings.json de VS Code:

{
  "mcp": {
    "servers": {
      "commet": {
        "type": "http",
        "url": "https://commet.co/mcp/v2"
      }
    }
  }
}

Agrega lo siguiente a ~/.gemini/settings.json:

{
  "mcpServers": {
    "commet": {
      "httpUrl": "https://commet.co/mcp/v2"
    }
  }
}

Agrega lo siguiente a opencode.json:

{
  "mcp": {
    "commet": {
      "type": "remote",
      "url": "https://commet.co/mcp/v2"
    }
  }
}

{
  "mcpServers": {
    "commet": {
      "serverUrl": "https://commet.co/mcp/v2"
    }
  }
}

Autenticación con API key

Para clientes que no pueden abrir login en navegador, agrega un header x-api-key:

claude mcp add --transport http commet https://commet.co/mcp/v2 --header "x-api-key: ck_xxxxxxxxx"

Para clientes configurados con JSON:

{
  "mcpServers": {
    "commet": {
      "url": "https://commet.co/mcp/v2",
      "headers": {
        "x-api-key": "ck_xxxxxxxxx"
      }
    }
  }
}

Las sesiones autenticadas con API key entran como el usuario que creó la key y usan exactamente la organización que creó esa key. Una key sandbox solo puede actuar sobre su organización sandbox; una key live solo puede actuar sobre su organización live. Crea la key desde una organización sandbox cuando experimentes.

Herramientas disponibles

MCP v2 expone una herramienta generada por cada operación del documento OpenAPI actual de Commet. Los nombres usan api_ seguido del operation ID en snake case:

list-plans   → api_list_plans
create-plan  → api_create_plan
track-usage  → api_track_usage

Todas las herramientas generadas agrupan el input de la misma forma:

path para parámetros de URL
query para filtros, cursores y paginación
body para el request body exacto del OpenAPI
idempotencyKey opcional para POST, PUT y PATCH

Las herramientas generadas siempre ejecutan la última versión de la API publicada por Commet. No leen ni modifican una versión anterior fijada para los SDKs de la organización. Las siguientes herramientas propias de Commet se mantienen:

Herramienta	Descripción
`get_current_organization`	Muestra la organización usada por las herramientas de API
`search_docs`	Busca en la documentación viva de Commet con una consulta semántica

El endpoint MCP anterior sigue disponible en https://commet.co/mcp con sus herramientas y comportamiento originales. Las conexiones nuevas deberían usar v2.

Antes de ejecutar una escritura o un borrado, revisa get_current_organization. Las operaciones sobre una organización live afectan clientes y dinero real de inmediato.

Inicio

Herramientas de AI

Agent Skills

¿Qué es un servidor MCP?

¿Qué puede hacer el servidor MCP de Commet?

Prerrequisitos

Cómo usar el servidor MCP

Autenticación con API key

Herramientas disponibles

​¿Qué es un servidor MCP?

​¿Qué puede hacer el servidor MCP de Commet?

​Prerrequisitos

​Cómo usar el servidor MCP

​Autenticación con API key

​Herramientas disponibles

¿Qué es un servidor MCP?

¿Qué puede hacer el servidor MCP de Commet?

Prerrequisitos

Cómo usar el servidor MCP

Autenticación con API key

Herramientas disponibles