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.)

Cómo usar el servidor MCP

Elige tu cliente preferido abajo.

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

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

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

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

codex mcp list

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

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

{
  "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:

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