Copiar para IA

Servidor MCP (Model Context Protocol)

El estándar abierto para proveer herramientas financieras a la Inteligencia Artificial Agéntica.

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar universal que permite a los asistentes de Inteligencia Artificial conectarse a fuentes de datos seguras.

Al configurar el Servidor MCP de Cord, empoderas a agentes como Claude o asistentes integrados en IDEs (como Cursor) para interactuar orgánicamente con tu empresa.

Preguntas que puedes hacer a la IA una vez conectada:

• “Extrae del PDF adjunto los requerimientos y genera una cotización en Cord para este cliente.”
• “Revisa las cotizaciones vencidas de los últimos 30 días y redáctame correos de cobranza amigables.”
• “Busca al cliente Distribuidora El Zarco y arma un borrador con estas 3 líneas.”

Conectar con Claude

Conecta Cord a ClaudeAgrega Cord desde el directorio de conectores de Claude y autoriza con tu cuenta. No pegas llaves ni editas archivos de configuración.Conectar con Claude

• Sin llaves: autorizas con OAuth
• Tú eliges qué puede hacer
• Lo desconectas cuando quieras

En Claude web, escritorio y móvil. Para ChatGPT, Cursor, VS Code o Claude Code, usa la URL de abajo.

Cord está en el directorio de conectores de Claude. En su ficha, Connect abre la pantalla Autorizar conexión de Cord: eliges el espacio de trabajo, decides si Claude puede pedir acciones que salen de Cord y autorizas. No pegas ninguna llave.

claude.ai/directory/cord

M

Copy link

Directory

CordQuotes, invoices and collections in Claude: check your pipeline and overdue accounts, and draft quotes and invoices that your team reviews in Cord.Connect

Cord is a sales closing platform that takes a deal from proposal to payment in a single link: quotes your customers approve and pay from one link, invoices, collections and payment tracking, in 13 markets across the Americas and Europe.Toolsactualizar_clienteaprobar_cotizacionbuscar_clientebuscar_documentacioncartera_vencidacontexto_cuentacorrer_workflowcrear_clientecrear_cotizacion_borradorcrear_factura_borradorcrear_tareadetalle_cotizaciondetalle_facturaenviar_cotizacionestado_configuracionlistar_cotizacioneslistar_eventoslistar_facturaslistar_productoslistar_workflows_manualesproponer_configuracionrechazar_cotizacionregistrar_pago_cotizacionregistrar_promesa_pagoresumen_negociovalidar_aparienciavalidar_datos_fiscalesOnly use connectors from developers you trust. Anthropic doesn't control which tools developers make available and can't verify that they work as intended or won't change.

Created byFlouviaCategoriesSales and marketingFinancial ServicesProductivitySign-inRequiredConnector URLhttps://cordhq.app/api/mcpDate addedNovember 2026More infoDocumentationSupportPrivacy policy

Ya conectado, le preguntas a Claude en lenguaje natural y él elige la herramienta de Cord que necesita:

claude.ai/chat/6b2f0c9e-1d4a

M

Facturas vencidasShare

¿Qué facturas tengo vencidas y quién me debe más?Cartera vencida

Tienes 3 facturas vencidas por $133,516.40 MXN:FAC-000231 · Constructora GAMA · $61,480.00 MXN · 18 díasFAC-000238 · Constructora Apex · $48,720.00 MXN · 9 díasFAC-000242 · Distribuidora El Zarco · $23,316.40 MXN · 3 díasLa más grande es la de Constructora GAMA, con 18 días de atraso. ¿Te preparo un recordatorio para cada cliente?

Reply to Claude…Opus 5.5

Conectar con la URL (OAuth)

Claude, ChatGPT, Claude Code, Cursor y VS Code se conectan con solo la URL del servidor, sin pegar ninguna llave:

https://cordhq.app/api/mcp

El cliente descubre solo dónde autorizar: su primera petición sin token recibe 401 con WWW-Authenticate: Bearer resource_metadata="https://cordhq.app/.well-known/oauth-protected-resource". Después se registra en Cord y abre en tu navegador la pantalla Autorizar conexión, donde eliges el espacio de trabajo y autorizas. Solo puede autorizar quien administra los Ajustes del espacio de trabajo. Los menús de cada cliente se citan en inglés, como los muestra su aplicación.

Cliente	Cómo se agrega
Claude (web y escritorio)	Desde el directorio, con el botón Conectar con Claude de arriba. También como conector propio: Customize › Connectors › Add › Add custom connector, con el nombre Cord y la URL de arriba. Si pregunta por el cliente OAuth, elige Register automatically. Después, Connect.
ChatGPT	Activa Developer mode en Settings › Apps & Connectors › Advanced settings. En Apps & Connectors, Create: nombre Cord, la URL de arriba y autenticación OAuth.
Claude Code	claude mcp add --transport http cord https://cordhq.app/api/mcp y, dentro de Claude Code, /mcp para autorizar en el navegador. Con --scope project queda en el .mcp.json del proyecto.
Cursor	El archivo .cursor/mcp.json del proyecto, o ~/.cursor/mcp.json para todos tus proyectos. Cursor abre la autorización al conectar.
VS Code	El archivo .vscode/mcp.json del proyecto, o MCP: Add Server › HTTP en la paleta de comandos.

Claude Code, en .mcp.json:

{
  "mcpServers": {
    "cord": { "type": "http", "url": "https://cordhq.app/api/mcp" }
  }
}

Cursor, en .cursor/mcp.json:

{
  "mcpServers": {
    "cord": { "url": "https://cordhq.app/api/mcp" }
  }
}

VS Code, en .vscode/mcp.json:

{
  "servers": {
    "cord": { "type": "http", "url": "https://cordhq.app/api/mcp" }
  }
}

Qué puede hacer una conexión con OAuth

Cada alcance abre un grupo de permisos por herramienta, los mismos que puede tener una llave:

Alcance	Grupo	Cuándo se concede
mcp:read	Lectura	Siempre
mcp:drafts	Escritura de borradores	Lo piden los clientes por omisión
mcp:actions	Acciones con efectos externos	Solo si al autorizar marcas También pedir acciones que salen de Cord; cada llamada sigue esperando aprobación

• La pantalla de autorizar dice a dónde vuelves. Claude, ChatGPT, Cursor y VS Code se reconocen por la dirección de regreso que publican; cualquier otra aplicación aparece como Aplicación no verificada por Cord, con su destino a la vista. Si el regreso es a tu propia computadora (localhost o 127.0.0.1), la pantalla te lo advierte: autoriza solo si acabas de conectar Cord desde ahí.
• El token de acceso dura una hora y el cliente lo renueva solo durante 180 días. Vale únicamente para el servidor MCP: no sirve en la API REST, y un token de Zapier o Make no sirve aquí.
• Si el agente llama una herramienta fuera de lo que autorizaste, el servidor responde 403 con error="insufficient_scope" y los alcances que faltan, y el cliente puede pedirte autorizar otra vez.
• La conexión aparece en la pestaña Llaves del Workbench con el nombre de la aplicación y la etiqueta OAuth; Revocar la desconecta. Sus llamadas cuentan igual que las de una llave (ver límites, medición y actividad).
• Para un cliente propio: la metadata del servidor de autorización está en https://cordhq.app/.well-known/oauth-authorization-server, el registro dinámico (RFC 7591) en POST https://cordhq.app/api/oauth/register y PKCE con S256 es obligatorio. Manda resource=https://cordhq.app/api/mcp al autorizar y al canjear el código (RFC 8707).

Conectar con una llave

Si prefieres no usar OAuth, o tu cliente no lo admite, autentícalo con tu Clave de API estándar de Cord (sk_live_… / sk_test_…) — la misma que usa la API REST.

1. Navega a Ajustes › MCP en la interfaz de Cord. Está en la sección Desarrolladores del índice de Ajustes, que aparece al activar el Modo desarrollador en Tu cuenta › Preferencias.
2. Un tablero de estado arriba te dice si ya tienes una llave activa y, si ya conectaste un cliente de IA, cuándo se usó por última vez. Si no tienes ninguna, el botón “Crear llave para MCP” genera una llave de escritura con los grupos de lectura y de escritura de borradores, sin salir de la página — se pega sola en la configuración de abajo. Cópiala en ese momento: no se vuelve a mostrar. Para elegir grupos o herramientas sueltas, o para permitir las acciones con efectos externos, crea o edita la llave en la pestaña Llaves del Cord Workbench (ver permisos por herramienta).
3. Copia la configuración JSON del cliente MCP proporcionada en pantalla.
4. Pega esta configuración en la ruta local correspondiente a tu cliente (por ejemplo, el archivo claude_desktop_config.json si usas la aplicación Claude for Desktop).

Dos formas de conectarte

Streamable HTTP (recomendado) — POST https://cordhq.app/api/mcp con el header Authorization: Bearer y el token de OAuth o la llave (sk_live_…). Sin sesión: cada mensaje JSON-RPC es una petición HTTP independiente. Es lo que espera la mayoría de los clientes MCP modernos.

HTTP + SSE (legacy, se mantiene para clientes antiguos) — GET https://cordhq.app/api/mcp/sse abre una conexión de larga duración y devuelve dónde mandar los mensajes (POST /api/mcp/message?sessionId=…). Cada mensaje POST debe llevar el mismo Authorization: Bearer con el que abriste la sesión — no basta con el sessionId de la URL (viaja en texto plano y puede quedar expuesto en logs de proxies intermedios), y la llave debe pertenecer a la misma organización que abrió la sesión.

Permisos por herramienta

Cada herramienta pertenece a un grupo y a un recurso, con el mismo modelo que las llaves restringidas:

Grupo	Herramientas	Llave sin lista
Lectura	listar_cotizaciones, detalle_cotizacion, cartera_vencida, resumen_negocio, buscar_cliente, listar_productos, listar_facturas, detalle_factura, listar_workflows_manuales, listar_eventos, estado_configuracion, validar_datos_fiscales, validar_apariencia	Permitidas
Escritura de borradores	crear_cotizacion_borrador, crear_factura_borrador, crear_cliente, crear_tarea, registrar_promesa_pago, proponer_configuracion	Permitidas con una llave de escritura
Acciones con efectos externos	enviar_cotizacion, aprobar_cotizacion, rechazar_cotizacion, registrar_pago_cotizacion, actualizar_cliente, correr_workflow, simular_evento	Bloqueadas: solo con permiso explícito, y cada llamada espera aprobación

Al crear o editar una llave en la pestaña Llaves del Workbench eliges grupos completos o, dentro de un grupo, herramientas sueltas. Un grupo cubre también las herramientas que Cord le agregue después; una herramienta suelta, solo esa. Una llave sin lista, como todas las que existían antes de los permisos por herramienta, conserva lectura y borradores según su nivel y no puede pedir ninguna acción con efectos externos hasta que alguien se lo permita.

• El nivel sigue mandando: una llave de solo lectura no usa borradores aunque estén en su lista, y una llave restringida (rk_) aplica el nivel de cada recurso a cada herramienta (listar_facturas pide facturas: read; crear_cotizacion_borrador, cotizaciones: write).
• tools/list solo devuelve lo que la llave puede llamar. Si un cliente llama otra, la respuesta es un error de herramienta que dice cuál falta y dónde permitirla.
• contexto_cuenta y buscar_documentacion están siempre disponibles: identifican la cuenta y buscan en esta documentación, sin datos de clientes.

actualizar_cliente está entre las acciones con efectos externos aunque no le escribe a nadie: Cord usa el correo y los datos fiscales del cliente para mandar recordatorios, facturas recurrentes y cobranza sin otra revisión, así que cambiarlos tiene efecto fuera de Cord.

Acciones que esperan aprobación

Una acción con efectos externos no se ejecuta cuando el agente la llama, aunque la llave la tenga permitida y el cliente MCP no pida confirmación. Así se ve en Claude:

claude.ai/chat/9a71e3d2-58c0

M

Enviar cotización a El ZarcoShare

Mándale la COT-0148 a Raúl Mendoza.Enviar cotización al cliente

Dejé la solicitud para enviar COT-0148 a Distribuidora El Zarco por $196,469.20 MXN. No sale hasta que alguien de tu equipo la apruebe en Cord.Aprobar en Cord

Reply to Claude…Opus 5.5

Cord guarda una solicitud y responde:

{
  "estado": "pendiente_de_aprobacion",
  "aprobacion_id": "7c1e4b2a-5d3f-4a8e-9b6c-2f1d0e3a4b5c",
  "aprobacion_url": "https://cordhq.app/app/ajustes/mcp/solicitudes?modo=vivo#sol-7c1e4b2a-5d3f-4a8e-9b6c-2f1d0e3a4b5c",
  "vence": "2026-10-18T16:04:00.000Z",
  "mensaje": "No se ejecutó todavía: una persona con acceso a Cord tiene que aprobarla. …"
}

1. El agente comparte aprobacion_url con el usuario.
2. En Ajustes › MCP › Solicitudes, una persona con permiso de Ajustes y con el permiso de la acción en la app (Cotizaciones para enviar o registrar un pago, Aprobaciones para aprobar o rechazar, Clientes para actualizar un cliente, Cotizaciones o Cobranza para un workflow según su objeto, Ajustes para simular un webhook) ve el documento, lo que cambiaría y los datos que mandó el agente, y aprueba o rechaza.
3. Al aprobar, Cord ejecuta la acción una sola vez, con el mismo manejador de siempre. Dos personas aprobando a la vez no la ejecutan dos veces. Rechazar no ejecuta nada.
4. Para saber el resultado, el agente repite la llamada con la misma idempotency_key: la respuesta trae estado ejecutada (con lo que devolvió la acción en resultado), fallida (con el motivo en error), rechazada o vencida.

La solicitud vence a las 72 horas sin decisión. Repetir la misma llamada con los mismos argumentos devuelve la solicitud pendiente en vez de crear otra, y una organización recibe como máximo 30 solicitudes por hora. Si la llave se revoca, vence o pierde la herramienta antes de la decisión, la solicitud ya no se puede aprobar. Con una llave de prueba, la solicitud vive en el entorno de prueba y el enlace lo indica con ?modo=prueba.

Herramientas disponibles

Tool	Qué hace	Permiso
listar_cotizaciones	Lista cotizaciones, con filtro opcional por estado.	lectura
detalle_cotizacion	Detalle completo de una cotización: líneas, totales, plan de pagos por hitos (cada pago con su importe en moneda, su vencimiento y si ya se puede pagar) y línea de tiempo.	lectura
cartera_vencida	Cuentas por cobrar VENCIDAS: monto, aging, detalle por cliente.	lectura
resumen_negocio	KPIs, embudo de conversión, pronóstico de pipeline, uso del plan.	lectura
buscar_cliente	Busca en el directorio por empresa/contacto/RFC/correo. Cada cliente trae language, el idioma de sus documentos (null = el de la organización). Paginado.	lectura
listar_productos	Catálogo de productos (id, SKU, nombre, unidad, precio de lista). Paginado.	lectura
crear_cotizacion_borrador	Crea una cotización en BORRADOR (no la envía). Idempotente si mandas idempotency_key.	borradores
listar_facturas	Lista las facturas de Cord Invoicing con su saldo y estado (draft|open|paid|void|uncollectible|overdue). Filtra por estado, cliente o texto libre. Paginado.	lectura
detalle_factura	Detalle completo de UNA factura: conceptos, emisor, receptor, impuestos, tipo de cambio declarado, saldo y pagos recibidos.	lectura
crear_factura_borrador	Crea una factura en BORRADOR para un cliente, sin necesidad de una cotización previa. Disponible en todos los planes, incluido Gratis.	borradores
enviar_cotizacion	Pide enviar al cliente una cotización en borrador (correo con el link), en el idioma de los documentos del cliente. Espera aprobación. En el plan Gratis consume un envío del mes.	con aprobación
aprobar_cotizacion	Pide marcar como aprobada una cotización enviada o vista. Espera aprobación.	con aprobación
rechazar_cotizacion	Pide marcar como rechazada una cotización enviada o vista. Espera aprobación.	con aprobación
registrar_pago_cotizacion	Pide registrar que una cotización aprobada se pagó por fuera de Cord; al ejecutarse cancela sus cobros en línea pendientes. Acepta metodo_pago. Espera aprobación.	con aprobación
crear_cliente	Da de alta un cliente (empresa, contacto, correo, teléfono, identificador fiscal, términos, país e idioma de los documentos: es, en, pt, fr, de o null).	borradores
actualizar_cliente	Pide cambiar datos de contacto de un cliente, también language. Solo modifica lo que mandas; nunca toca crédito, nivel ni descuento. Lo ya enviado conserva su idioma. Espera aprobación.	con aprobación
crear_tarea	Crea una tarea de seguimiento: titulo (obligatorio), fecha límite YYYY-MM-DD, cotizacion_id y factura_id opcionales. Nace sin responsable y con prioridad normal; eso se cambia en la app.	borradores
registrar_promesa_pago	Registra la fecha en que el cliente prometió pagar una cotización. No cobra nada.	borradores
listar_workflows_manuales	Lista los workflows activos “Lo corres tú”, por objeto (quote o invoice).	lectura
correr_workflow	Pide correr un workflow “Lo corres tú” sobre hasta 50 cotizaciones o facturas, con la versión publicada y sus reglas. Espera aprobación; al ejecutarse dice cuántas ejecuciones empezaron.	con aprobación
listar_eventos	Historial del negocio (cotizaciones, facturas, clientes, tareas, promesas), filtrable por tipo u objeto. Paginado.	lectura
contexto_cuenta	Negocio, país, divisa, idioma, zona horaria, plan y si la llave es de prueba o en vivo. Úsala primero.	lectura
proponer_configuracion	Propone perfil, marca, impuestos, catálogo y plantillas a partir del sitio, una descripción o la lista de precios (base64, hasta 3 MB). No aplica nada: devuelve review_url para que una persona la apruebe.	borradores
estado_configuracion	Estado de una propuesta (propuesto, aplicado, descartado, fallido) y el resultado por sección.	lectura
validar_datos_fiscales	Valida RFC, régimen, uso de CFDI y código postal (México), NIF/NIE/CIF (España) o EIN (EE. UU.) con las mismas reglas que al emitir.	lectura
validar_apariencia	Valida un objeto appearance de Elements y dice qué claves descartaría Cord.	lectura
simular_evento	Pide disparar un webhook de prueba por el motor real de entrega. Solo con llave de prueba. Espera aprobación.	con aprobación
buscar_documentacion	Busca en esta documentación y devuelve las páginas más relevantes con extracto y URL.	lectura

Cada tool declara sus anotaciones estándar de MCP (readOnlyHint, idempotentHint, destructiveHint) en tools/list. Las de lectura son readOnlyHint: true y las que cambian el estado de una cotización son destructiveHint: true. La confirmación no depende de que el cliente MCP respete esas anotaciones: Cord no ejecuta ninguna acción con efectos externos hasta que una persona la aprueba (ver acciones que esperan aprobación). Ninguna herramienta emite ni timbra facturas: eso sigue siendo una acción que una persona dispara desde la app o la API.

Ninguna herramienta cambia los ajustes de la cuenta directamente: proponer_configuracion deja una propuesta que una persona con permiso de Ajustes revisa y aprueba en Cord, igual que la que genera el onboarding o cord setup.

Toda herramienta declara outputSchema y responde con structuredContent (el JSON validable) además del texto. Los importes viajan con su divisa en moneda: nunca asumas pesos.

Paginación

listar_cotizaciones, buscar_cliente, listar_productos, listar_facturas y listar_eventos devuelven páginas, no la tabla completa. Hay dos formas de respuesta.

buscar_cliente y listar_productos devuelven la lista en items, con total, has_more, next_cursor y la divisa en moneda; listar_cotizaciones devuelve total, has_more y next_cursor con la lista en cotizaciones, y la divisa va en cada cotización:

{
  "items": [ { "id": "9a1c3e5f-7b2d-4f6a-8c0e-1d3b5f7a9c2e", "empresa": "Distribuidora El Zarco" } ],
  "total": 47,
  "moneda": "MXN",
  "has_more": true,
  "next_cursor": "20"
}

listar_facturas y listar_eventos devuelven solo la lista (en facturas o eventos) y next_cursor, sin total ni has_more:

{
  "eventos": [ { "id": "6b0e2f4a-8c1d-4e3b-9a5f-7d2c0e8b1a46", "type": "quote.approved" } ],
  "next_cursor": "MjAyNi0wOS0xNFQxODozMjowNC4xMjMwMDBafDZiMGUyZjRhLThjMWQtNGUzYi05YTVmLTdkMmMwZThiMWE0Ng"
}

En todos los casos, vuelve a llamar la misma tool pasando cursor: next_cursor para la siguiente página. next_cursor viene en null cuando ya no hay más resultados.

Llamadas seguras de repetir (idempotencia)

crear_cotizacion_borrador, crear_cliente, crear_tarea, registrar_promesa_pago y las siete acciones con efectos externos aceptan un idempotency_key opcional — un identificador único que tú generas (un UUID, por ejemplo). Si tu cliente MCP necesita reintentar la llamada porque no recibió respuesta a tiempo (timeout de red), repite el MISMO idempotency_key: Cord te devuelve el resultado de la primera vez en vez de repetir la acción. En una acción con efectos externos, la misma clave devuelve el estado actual de su solicitud (pendiente, ejecutada, rechazada…). Reusar la misma clave con otros argumentos devuelve un error, y en las demás herramientas la clave caduca a las 24 horas.

{
  "name": "crear_cotizacion_borrador",
  "arguments": {
    "idempotency_key": "a1b2c3d4-…",
    "cliente_id": "9a1c3e5f-7b2d-4f6a-8c0e-1d3b5f7a9c2e",
    "items": [{ "descripcion": "Instalación", "cantidad": 1, "precio_unitario": 4500 }]
  }
}

Sin idempotency_key, la tool sigue funcionando normal — cada llamada crea un borrador nuevo (no es un campo obligatorio, solo recomendado si tu cliente reintenta automáticamente).

Herramientas Seguras (Tools)

Cord expone de forma controlada “Herramientas” (Tools) hacia la IA. Esto significa que la IA no tiene acceso crudo e ilimitado a tu base de datos; la IA únicamente puede invocar los endpoints que Cord ha aprobado y categorizado, heredando los permisos vinculados a la Clave de API.

Límites, medición y actividad

Cada llamada real (no las notificaciones de protocolo como notifications/initialized) cuenta igual que una llamada a la API REST contra tu cuota de uso del plan. Toda petición HTTP al servidor MCP, incluidas las notificaciones, cuenta contra los límites por minuto de la API (600 por llave secreta; por IP solo cuentan las peticiones sin llave o con una inválida), y las herramientas que cambian el estado de una cotización comparten además el límite de 120 por minuto por organización; ver la tabla de límites. Cada llamada queda en la pestaña Registros del Cord Workbench con la tool que se llamó (ej. /mcp/tools/call:listar_productos) — así puedes ver exactamente qué está haciendo tu agente, con qué llave y cuándo. Puedes filtrar ese log por método o por status, o buscar mcp en la ruta para aislar solo lo que hizo la IA.

Las acciones con efectos externos dejan rastro completo: cada llamada aparece en Registros con la llave que la hizo, la decisión aparece en Ajustes › Auditoría con la persona que aprobó o rechazó, y la acción ejecutada se audita como hecha por esa llave.