Generar código con MCP

Una vez conectado el MCP de documentación pública de Cobre, su agente de IA puede leer la especificación OpenAPI en vivo y generar código, modelos, pruebas, tickets y criterios de aceptación que coincidan con la API publicada — en lugar de adivinar a partir de datos de entrenamiento.

Esta página es para product managers y desarrolladores. Úsela después de completar Construye con AI.

Actualice siempre MCP antes de generar cualquier cosa. La spec se cachea localmente. Si Cobre publicó un cambio de campo, enum o error, una caché obsoleta producirá código incorrecto.

Refresh MCP and reload the latest API specification.

Para qué sirve MCP (y para qué no)

Use MCP para	Use las páginas de documentación para	No use MCP para
Paths, métodos, campos requeridos, enums, ejemplos, formas de error	Comportamiento de producto, horarios operativos, narrativa de conciliación, certificación	Precios, KYC, límites por cuenta, credenciales o rieles no publicados

Mejor práctica: pida al agente que use MCP para el contrato y llms.txt para la guía de contexto. Consulte Conecta la documentación de Cobre a la IA.

Trate el código generado como un borrador. Revise cada nombre de campo, enum y status contra el Explorador de API antes de hacer merge. Si el agente y docs.cobre.com no coinciden, confíe en la documentación publicada.

Cómo escribir el prompt

Trabaje en modo agent (el agente debe poder llamar herramientas MCP). Empiece por el objetivo de negocio, luego fije el contrato y después genere.

Actualizar la spec

Descripción: Pida al agente que actualice MCP.

Qué esperar después de la acción: El agente vuelve a descargar la especificación OpenAPI. Las respuestas siguientes usan campos y ejemplos vigentes.

Nombrar el resultado

Descripción: Diga qué necesita (una clase de servicio, un handler de webhook, un ticket de Jira, criterios de aceptación) y el lenguaje o tracker que usa.

Qué esperar después de la acción: El agente conoce el entregable antes de abrir schemas.

Anclar en MCP

Descripción: Indique al agente que lea endpoints y schemas desde MCP. Dígale que no invente campos, statuses ni códigos de error.

Qué esperar después de la acción: Los tipos y payloads generados coinciden con el OAS, incluidos campos required vs optional.

Revisar e iterar

Descripción: Compare el resultado con la Guía de API y la página del Explorador correspondientes. Pida un diff contra la spec si algo parece inventado.

Qué esperar después de la acción: Un parche que puede compartir con ingeniería, no una segunda conjetura.

Copie un prompt de los grupos siguientes y reemplace los placeholders (<language>, <path in your repo>, <geography>).

Product managers

Úselos cuando necesite convertir una idea de producto en algo que ingeniería pueda construir en este sprint — sin esperar un Solution Design si solo necesita un recorte.

Mapear un requerimiento a endpoints

Redactar criterios de aceptación a partir de la spec

Comparar dos geografías o productos

Definir el modelo de eventos de una funcionalidad

Verificar un campo, status o error antes de comprometerse

Producir un brief de kickoff de ingeniería

Desarrolladores

Úselos en el repositorio donde vivirá la integración. Nombre su lenguaje y la ruta de archivo en la que quiere que el agente escriba.

Generar modelos tipados a partir de schemas del OAS

Andamiar un cliente HTTP autenticado

Crear un Counterparty y luego un Money Movement

Construir un listener de webhooks

Manejar errores de la spec

Mantener DTOs existentes sincronizados con el OAS

Generar pruebas a partir de ejemplos oficiales

Mapear conciliación desde webhooks y reportes

Combinar MCP con docs y demo flows

Fuente	Cuándo
MCP (OAS)	Campos, enums, ejemplos, códigos HTTP — cualquier código o DTO generado
llms.txt + Guías de API	Secuencia, prerrequisitos, modelo operativo — cualquier diseño o ticket
Demo Flow Library	Enseñar la secuencia a un ingeniero nuevo — Explorar ejemplos de flujos de API

Prompt de ejemplo que usa los tres:

Refresh MCP. Read https://docs.cobre.com/llms.txt for the payout guides. Then, using only OAS schemas, generate a <language> service that authenticates, creates a Counterparty, creates a Money Movement, and handles completion and failure webhooks. After the code, list the demo flow in https://cobre-demo-flows.cobre.co/index.html that is closest to this sequence. Do not invent fields.

Checklist de revisión

Antes de hacer merge del código generado o de enviar un brief de PM a ingeniería:

MCP se actualizó en esta sesión

Cada key JSON existe en el OAS (busque en el schema; no se fíe del chat)

Los enums y valores de status.state se copiaron de la spec, no se normalizaron a su propio vocabulario

Los headers y campos del envelope de webhook coinciden con Notificaciones y Suscripciones

No hay cifras de precios, KYC o límites salvo que aparezcan en la documentación publicada

Las preguntas abiertas están listadas, no rellenadas con conjeturas

Cuando Cobre publique un cambio de API, actualice MCP y vuelva a ejecutar el prompt Mantener DTOs existentes sincronizados. Consulte Gestión de cambios en la API y productos.

Guías relacionadas

Cómo integrarse con Cobre — recorrido del cliente desde pre-sales hasta go-live

Construye con AI — conectar el MCP de Cobre Docs en su IDE

Crear un Solution Design con IA — diseño de integración completo cuando el recorte es mayor que un ticket

Explorar ejemplos de flujos de API — recorridos interactivos de las mismas secuencias

Conecta la documentación de Cobre a la IA — usar llms.txt para respuestas ancladas en la documentación

Generar código con MCP

Para qué sirve MCP (y para qué no)#

Cómo escribir el prompt#

Product managers#

Desarrolladores#

Combinar MCP con docs y demo flows#

Checklist de revisión#

Guías relacionadas#

Para qué sirve MCP (y para qué no)

Cómo escribir el prompt

Product managers

Desarrolladores

Combinar MCP con docs y demo flows

Checklist de revisión

Guías relacionadas