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

Organizaciones — listar, crear, cambiar y obtener la organización actual
Planes — crear, actualizar, eliminar y alternar la visibilidad de los planes. Agregar y quitar precios y features
Features — crear, actualizar, eliminar features y tipos de licencia
Clientes — listar, buscar, crear y actualizar clientes. Ver sus suscripciones, recibos y uso
Suscripciones — buscar suscripciones, ver detalles, recibos y transacciones
Recibos — buscar recibos, ver line items, obtener resumen de cobros
Uso — ver el resumen de uso por feature o por cliente
Transacciones — listar transacciones recientes, ver resumen financiero
Addons — crear, actualizar y archivar add-ons vinculados a features
Códigos promo — alternar códigos promo entre activo e inactivo
API Keys — crear y eliminar API keys para integración con el SDK

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

Una vez conectado, elige una organización sandbox o live con la herramienta switch-organization. Los comandos corren contra la organización activa.

Para usarlo, necesitas:

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

No se necesita API key. La autenticación pasa automáticamente por OAuth cuando tu cliente se conecta.

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"
    }
  }
}

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

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

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

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

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"
      }
    }
  }
}

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

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

Agrega lo siguiente a opencode.json:

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

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

Herramientas disponibles

El servidor MCP expone las siguientes herramientas una vez conectado:

Organizaciones

Herramienta	Descripción
`list-organizations`	Lista todas las organizaciones a las que tienes acceso (live y sandbox)
`get-current-organization`	Obtiene la organización activa
`switch-organization`	Cambia a otra organización
`create-organization`	Crea una nueva organización

Planes y features

Herramienta	Descripción
`list-plans`	Lista todos los planes de la organización actual
`create-plan`	Crea un nuevo plan
`update-plan`	Actualiza el nombre o descripción de un plan
`delete-plan`	Borrado suave de un plan. No se puede eliminar un plan que tiene suscripciones
`toggle-plan-visibility`	Alterna un plan entre público y privado. Los planes privados se ocultan pero las suscripciones existentes conservan el acceso
`add-plan-price`	Agrega un precio a un plan
`add-plan-feature`	Agrega una feature a un plan
`remove-plan-feature`	Quita una feature de un plan
`list-features`	Lista todas las features de la organización actual
`create-feature`	Crea una nueva feature
`update-feature`	Actualiza el nombre, descripción o unit name de una feature
`delete-feature`	Borrado suave de una feature. Primero debe quitarse de todos los planes
`create-seat-type`	Crea un nuevo tipo de licencia
`update-seat-type`	Actualiza el nombre o descripción de un tipo de licencia
`delete-seat-type`	Borrado suave de un tipo de licencia. Primero debe quitarse de todas las features
`list-seat-types`	Lista todos los tipos de licencia

Clientes

Herramienta	Descripción
`list-customers`	Lista todos los clientes
`search-customers`	Busca clientes por nombre o email
`create-customer`	Crea un nuevo cliente
`update-customer`	Actualiza el email de cobro, el nombre o la zona horaria de un cliente
`get-customer`	Obtiene los detalles del cliente con dirección
`get-customer-subscriptions`	Ve las suscripciones de un cliente
`get-customer-invoices`	Ve los recibos de un cliente
`get-customer-usage`	Ve los datos de uso de un cliente

Suscripciones

Herramienta	Descripción
`search-subscriptions`	Busca suscripciones por nombre, cliente o plan
`get-subscription`	Obtiene los detalles completos de una suscripción con balance y precios
`get-subscription-invoices`	Ve los recibos de una suscripción
`get-subscription-transactions`	Ve las transacciones de pago de una suscripción

Recibos y cobros

Herramienta	Descripción
`search-invoices`	Busca recibos por número o filtra por estado
`get-invoice`	Obtiene el recibo con sus line items
`get-invoice-summary`	Obtiene el resumen de cobros por estado

Uso y transacciones

Herramienta	Descripción
`get-usage-summary`	Obtiene el resumen de uso agregado por feature
`list-transactions`	Lista transacciones recientes con filtro opcional por estado
`get-transaction-summary`	Obtiene el resumen financiero de transacciones

Addons

Herramienta	Descripción
`create-addon`	Crea un nuevo add-on vinculado a una feature con su propio precio y modelo de consumo
`update-addon`	Actualiza el nombre, descripción o precio base de un add-on
`delete-addon`	Archiva (borrado suave) un add-on. No se puede archivar con suscripciones activas

Herramienta	Descripción
`toggle-promo-code`	Alterna un código promo entre activo e inactivo. Los códigos inactivos no se pueden canjear en el checkout

API Keys

Herramienta	Descripción
`create-api-key`	Crea una API key para integración con el SDK
`delete-api-key`	Elimina permanentemente una API key. Las aplicaciones que la usen perderán acceso inmediatamente

¿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?

Organizaciones — listar, crear, cambiar y obtener la organización actual
Planes — crear, actualizar, eliminar y alternar la visibilidad de los planes. Agregar y quitar precios y features
Features — crear, actualizar, eliminar features y tipos de licencia
Clientes — listar, buscar, crear y actualizar clientes. Ver sus suscripciones, recibos y uso
Suscripciones — buscar suscripciones, ver detalles, recibos y transacciones
Recibos — buscar recibos, ver line items, obtener resumen de cobros
Uso — ver el resumen de uso por feature o por cliente
Transacciones — listar transacciones recientes, ver resumen financiero
Addons — crear, actualizar y archivar add-ons vinculados a features
Códigos promo — alternar códigos promo entre activo e inactivo
API Keys — crear y eliminar API keys para integración con el SDK

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

Una vez conectado, elige una organización sandbox o live con la herramienta switch-organization. Los comandos corren contra la organización activa.

Para usarlo, necesitas:

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

No se necesita API key. La autenticación pasa automáticamente por OAuth cuando tu cliente se conecta.

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"
    }
  }
}

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

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

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

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

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"
      }
    }
  }
}

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

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

Agrega lo siguiente a opencode.json:

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

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

Herramientas disponibles

El servidor MCP expone las siguientes herramientas una vez conectado:

Organizaciones

Herramienta	Descripción
`list-organizations`	Lista todas las organizaciones a las que tienes acceso (live y sandbox)
`get-current-organization`	Obtiene la organización activa
`switch-organization`	Cambia a otra organización
`create-organization`	Crea una nueva organización

Planes y features

Herramienta	Descripción
`list-plans`	Lista todos los planes de la organización actual
`create-plan`	Crea un nuevo plan
`update-plan`	Actualiza el nombre o descripción de un plan
`delete-plan`	Borrado suave de un plan. No se puede eliminar un plan que tiene suscripciones
`toggle-plan-visibility`	Alterna un plan entre público y privado. Los planes privados se ocultan pero las suscripciones existentes conservan el acceso
`add-plan-price`	Agrega un precio a un plan
`add-plan-feature`	Agrega una feature a un plan
`remove-plan-feature`	Quita una feature de un plan
`list-features`	Lista todas las features de la organización actual
`create-feature`	Crea una nueva feature
`update-feature`	Actualiza el nombre, descripción o unit name de una feature
`delete-feature`	Borrado suave de una feature. Primero debe quitarse de todos los planes
`create-seat-type`	Crea un nuevo tipo de licencia
`update-seat-type`	Actualiza el nombre o descripción de un tipo de licencia
`delete-seat-type`	Borrado suave de un tipo de licencia. Primero debe quitarse de todas las features
`list-seat-types`	Lista todos los tipos de licencia

Clientes

Herramienta	Descripción
`list-customers`	Lista todos los clientes
`search-customers`	Busca clientes por nombre o email
`create-customer`	Crea un nuevo cliente
`update-customer`	Actualiza el email de cobro, el nombre o la zona horaria de un cliente
`get-customer`	Obtiene los detalles del cliente con dirección
`get-customer-subscriptions`	Ve las suscripciones de un cliente
`get-customer-invoices`	Ve los recibos de un cliente
`get-customer-usage`	Ve los datos de uso de un cliente

Suscripciones

Herramienta	Descripción
`search-subscriptions`	Busca suscripciones por nombre, cliente o plan
`get-subscription`	Obtiene los detalles completos de una suscripción con balance y precios
`get-subscription-invoices`	Ve los recibos de una suscripción
`get-subscription-transactions`	Ve las transacciones de pago de una suscripción

Recibos y cobros

Herramienta	Descripción
`search-invoices`	Busca recibos por número o filtra por estado
`get-invoice`	Obtiene el recibo con sus line items
`get-invoice-summary`	Obtiene el resumen de cobros por estado

Uso y transacciones

Herramienta	Descripción
`get-usage-summary`	Obtiene el resumen de uso agregado por feature
`list-transactions`	Lista transacciones recientes con filtro opcional por estado
`get-transaction-summary`	Obtiene el resumen financiero de transacciones

Addons

Herramienta	Descripción
`create-addon`	Crea un nuevo add-on vinculado a una feature con su propio precio y modelo de consumo
`update-addon`	Actualiza el nombre, descripción o precio base de un add-on
`delete-addon`	Archiva (borrado suave) un add-on. No se puede archivar con suscripciones activas

Herramienta	Descripción
`toggle-promo-code`	Alterna un código promo entre activo e inactivo. Los códigos inactivos no se pueden canjear en el checkout

API Keys

Herramienta	Descripción
`create-api-key`	Crea una API key para integración con el SDK
`delete-api-key`	Elimina permanentemente una API key. Las aplicaciones que la usen perderán acceso inmediatamente

Servidor MCP

¿Qué es un servidor MCP?

¿Qué puede hacer el servidor MCP de Commet?

Prerrequisitos

Cómo usar el servidor MCP

Herramientas disponibles

Organizaciones

Planes y features

Clientes

Suscripciones

Recibos y cobros

Uso y transacciones

Addons

API Keys

En esta página

Servidor MCP

¿Qué es un servidor MCP?

¿Qué puede hacer el servidor MCP de Commet?

Prerrequisitos

Cómo usar el servidor MCP

Herramientas disponibles

Organizaciones

Planes y features

Clientes

Suscripciones

Recibos y cobros

Uso y transacciones

Addons

API Keys

En esta página