Los asistentes de programación con IA solo pueden acortar una integración cuando trabajan con fuentes precisas y actualizadas. Hemos renovado la documentación pública de la API de CoinsSend para que los desarrolladores y los agentes de programación compatibles puedan utilizar el mismo contrato revisado, los mismos ejemplos y las mismas recomendaciones de seguridad.
Esta versión reúne un servidor MCP público de solo lectura, un documento OpenAPI 3.1 canónico, un índice de documentación adaptado a los LLM, vectores de prueba para firmas de solicitudes y comprobaciones automatizadas más rigurosas. Así resulta más rápido explorar la API y preparar el código de integración, mientras las credenciales y las operaciones de pago siguen bajo el control del desarrollador.
Una única fuente revisada para desarrolladores y agentes
La nueva capa de documentación ofrece a cada herramienta el formato que mejor sabe utilizar:
- MCP para agentes de programación. Un cliente compatible puede buscar en la documentación pública, obtener una página concreta, inspeccionar una operación OpenAPI o cargar el esquema de un componente.
- OpenAPI 3.1 para herramientas. El contrato público permite generar código, validar integraciones, explorar la API y crear pruebas de integración.
- llms.txt y un manifiesto de documentación. Los agentes que no utilizan MCP pueden descubrir las páginas públicas canónicas sin rastrear contenido ajeno.
- Vectores de prueba de firmas ejecutables. Los equipos pueden verificar el JSON canónico, las firmas MD5 heredadas y las firmas HMAC con marca temporal para retiros utilizando los casos publicados.
- Ejemplos del lado del servidor y prompts con medidas de seguridad. La documentación incluye ejemplos en PHP, JavaScript/Node.js y Python, además de prompts para tareas de checkout, webhooks y refuerzo de producción.
El contrato OpenAPI abarca deliberadamente un conjunto revisado de operaciones públicas, en lugar de exponer rutas internas de la aplicación. Este límite mantiene la superficie legible por máquinas útil y auditable.
Conecta un agente de programación en minutos
El servidor remoto de documentación está disponible en https://api.coinssend.com/v1/docs/mcp. Por ejemplo, los usuarios de Codex pueden añadirlo con:
codex mcp add coinssend-docs --url https://api.coinssend.com/v1/docs/mcpNo se necesita una clave de la API de CoinsSend para esta conexión, porque el servidor solo proporciona documentación pública. Otros clientes MCP compatibles pueden utilizar el mismo endpoint siguiendo su propio proceso de conexión. Las instrucciones completas están disponibles en la guía de MCP.
En qué puede ayudar un agente
Una vez conectado el servidor de documentación, un agente de programación puede:
- buscar el flujo de trabajo pertinente, como facturas, billeteras estáticas, webhooks, retiros, comisiones, saldos o tipos de cambio;
- obtener la página exacta de la documentación pública en lugar de depender de una búsqueda web general;
- localizar una operación por su
operationIde inspeccionar sus esquemas de solicitud, respuesta, autenticación y errores; - utilizar los casos de firma publicados para probar la implementación de firmas de la aplicación;
- preparar código de integración del lado del servidor y pruebas para que un ingeniero los revise y ejecute.
Si estás eligiendo entre distintos modelos de pago antes de la implementación, nuestra guía sobre carteras estáticas y facturas explica las ventajas y desventajas de cada opción para el producto. Después, la documentación preparada para agentes proporciona el contrato exacto de la API para el camino elegido.
Un límite de seguridad claro
El servidor MCP es de solo lectura. No puede crear una factura, generar una billetera, iniciar un retiro, acceder a una cuenta de comerciante ni recibir credenciales de comerciantes. Sus herramientas se limitan a un corpus revisado de documentación pública y están diseñadas para ser no destructivas e idempotentes.
El código de integración debe seguir ejecutándose en un servidor de confianza. Guarda las claves del comerciante en variables de entorno protegidas o en un gestor de secretos, firma las solicitudes en el servidor, verifica las firmas de los webhooks a partir del cuerpo sin procesar de la solicitud y revisa el código generado antes de ejecutarlo. Las solicitudes de escritura deben respetar el comportamiento de reintentos documentado y nunca deben repetirse a ciegas.
OpenAPI, vectores de prueba y acceso directo
El mismo material fuente está disponible sin MCP:
- el contrato OpenAPI 3.1 para operaciones y esquemas legibles por máquinas;
- llms.txt como índice compacto orientado a agentes;
- el manifiesto de documentación del corpus público canónico;
- los vectores de prueba de firmas para comprobaciones de firma interoperables;
- los prompts de integración con IA para tareas estructuradas de implementación y revisión.
De este modo, un equipo puede utilizar un agente compatible con MCP, importar OpenAPI en sus herramientas actuales o trabajar directamente con la documentación sin dejar de usar la misma fuente de verdad.
Comprobaciones que mantienen alineado el contrato
Ahora los cambios en la documentación pasan comprobaciones automatizadas de coherencia, validación de OpenAPI, detección de cambios incompatibles y pruebas del contrato en tiempo de ejecución que comparan la especificación publicada con las rutas públicas, los controladores y el middleware reales. Otras pruebas cubren el servidor MCP, el corpus documental, las firmas de solicitudes y la sincronización administrada con OpenAI Vector Store que utiliza el asistente de documentación de CoinsSend.
El flujo de sincronización prepara y verifica un nuevo corpus público antes de retirar los archivos administrados anteriores. Los bloqueos, la paginación, los tiempos de espera, las comprobaciones de propiedad y la limpieza reducen el riesgo de publicar un corpus parcial o no previsto.
Empieza por el flujo de trabajo y después verifica los detalles
Abre la guía de primeros pasos, conecta el servidor de documentación si tu agente de programación admite MCP y describe el flujo de pago que quieres desarrollar. Pide al agente que cite la página exacta de la documentación, la operación OpenAPI y el esquema que haya utilizado. Después, revisa el resultado, ejecuta los casos de firma y las pruebas, y valida la integración en tu propio entorno.
Esta versión no convierte la integración de pagos en una acción de un solo clic sin revisión. Proporciona a los desarrolladores y a sus herramientas una forma más rápida y fiable de llegar al contrato correcto y desarrollar a partir de él.
