Saltar al contenido principal
Dale a tu asistente acceso a la documentación actual de Bridge antes de pedirle que construya tu integración. Elige tu herramienta, agrega el endpoint público MCP y comprueba la conexión.
Esto conecta tu asistente a la documentación de Bridge. No lo conecta a tu espacio de trabajo ni le da permiso para crear contactos o enviar mensajes. Tu integración usa por separado las credenciales de la API REST o la configuración pública de Custom Connections. El servidor de documentación también ofrece una herramienta opcional para enviar comentarios sobre la documentación a Bridge.

Elige tu asistente de programación

Codex

Configuración de CLI y del IDE local.

Claude Code

Agrega un comando y comprueba la conexión.

Cursor

Agrega el servidor al archivo MCP de tu proyecto.

GitHub Copilot

Configuración guiada en VS Code o configuración portátil del proyecto.

Codex

Antes de comenzar: debes tener instalado Codex CLI o la extensión de Codex para tu IDE. Para la CLI, agrega el servidor desde la terminal:
La lista debe incluir bridgeDocs con la URL de documentación de Bridge. Que aparezca confirma la configuración; usa la comprobación de conexión para confirmar que realmente puede leer la documentación. Si prefieres editar la configuración, agrega esta entrada a ~/.codex/config.toml. Conserva las demás opciones y los otros servidores:
Reinicia el cliente o la extensión después de cambiar su configuración. En la interfaz de terminal de Codex, /mcp muestra los servidores activos. Los clientes locales de Codex pueden compartir la configuración en el mismo equipo; los entornos remotos pueden tener configuraciones y políticas independientes. Ejemplo de prompt:
Usa bridgeDocs para leer el contrato REST de Bridge y la guía de primera conversación. Prepara una integración en Node.js que cree un contacto, inicie una conversación y cree un mensaje. Enumera primero los identificadores y la configuración necesarios. Conserva todos los campos y tipos de la API, cita tus fuentes y no hagas solicitudes reales a la API.
Guía oficial de MCP para Codex.

Claude Code

Antes de comenzar: debes tener instalado Claude Code. Agrega el servidor a tu configuración personal para usarlo en distintos proyectos:
Si prefieres una configuración compartida del proyecto, usa --scope project en lugar de --scope user. Revisa la configuración resultante antes de guardarla en el repositorio. Inicia Claude Code y usa /mcp para inspeccionar bridgeDocs. Después ejecuta la comprobación de conexión. El endpoint de documentación de Bridge no necesita una clave de API de Bridge ni iniciar sesión con OAuth. Ejemplo de prompt:
Usa bridgeDocs para leer las guías actuales de verificación y recepción de webhooks de Bridge. Implementa un receptor en Python con la representación HMAC documentada y aceptación duradera antes de confirmar la recepción. Agrega pruebas sin conexión usando el vector de firma publicado. Explica la limitación de la marca de tiempo y el manejo de duplicados, y cita las páginas utilizadas.
Guía oficial de MCP para Claude Code.

Cursor

Antes de comenzar: abre tu proyecto de integración en Cursor. Crea o actualiza .cursor/mcp.json en ese proyecto. Combina la entrada con los servidores existentes:
Para una configuración personal entre proyectos, usa ~/.cursor/mcp.json. En la barra lateral Customize de Cursor, comprueba que el servidor esté habilitado. Abre una conversación de Agent y ejecuta la comprobación de conexión; las herramientas MCP pertinentes aparecen en Available Tools. Revisa las solicitudes de uso de herramientas cuando Cursor te lo pida. Ejemplo de prompt:
Usa bridgeDocs para encontrar el flujo completo de adjuntos PDF. Implementa una carga desde el servidor que calcule el SHA-256 en Base64 de los bytes exactos del archivo, solicite una carga prefirmada, ejecute el PUT obligatorio y cree un mensaje con el mediaId devuelto. Conserva los campos documentados y explica cómo manejar los fallos de cada etapa. No envíes una clave de API de Bridge a la URL de carga.
Guía oficial de MCP para Cursor.

GitHub Copilot

Antes de comenzar: habilita GitHub Copilot en VS Code y abre la carpeta de tu proyecto. Selecciona Copilot como destino de la sesión.
  1. Abre la paleta de comandos con Command + Shift + P en macOS o Ctrl + Shift + P en Windows/Linux.
  2. Ejecuta MCP: Add Server y elige HTTP (HTTP or Server-Sent Events).
  3. Introduce https://docs.bridge.new/mcp y llama al servidor bridgeDocs.
  4. Elige Global → Copilot Global para tu configuración personal, cuando esté disponible. Revisa el destino que muestra tu versión de VS Code y cualquier solicitud de confianza del servidor.
  5. Abre una conversación de Copilot, habilita las herramientas de documentación de Bridge para esa sesión y ejecuta la comprobación de conexión.
Para un proyecto compartido con la configuración portátil actual de Copilot, crea o combina esta entrada en .mcp.json, en la raíz del espacio de trabajo:
El formato portátil de Copilot anterior difiere de .vscode/mcp.json, administrado por el editor, que usa un objeto servers. Usa el archivo correspondiente a la conexión elegida; no mezcles ambos formatos. Si el destino portátil no está disponible en tu versión, usa la configuración guiada y el archivo que seleccione. Ejemplo de prompt:
Usa bridgeDocs para leer la guía de Custom Connections y su contrato OpenAPI independiente. Prepara un formulario de landing page que registre el consentimiento, obtenga un token CAPTCHA nuevo en cada intento y presente un 202 como aceptado con su requestId. Conserva captureKey, los campos de solicitud y la acción CAPTCHA configurada. No uses una clave de la API REST en la página.
Configuración oficial de VS Code · Referencia de configuración de Copilot.

Comprueba la conexión

Después de configurar cualquiera de los cuatro clientes, pregunta lo siguiente:
Usa el servidor MCP de documentación de Bridge para buscar cómo crear un mensaje. Lee el esquema MessageRequest en el OpenAPI REST publicado. ¿Qué tres campos son obligatorios y un 201 exitoso demuestra la entrega por WhatsApp? Cita la fuente exacta de Bridge que leíste. No llames a la API de negocio.
Una comprobación exitosa usa una herramienta de documentación y cita una página o esquema de Bridge. Debe identificar conversationId, messageBody y enableExternalBroadcast como obligatorios y distinguir un mensaje creado de una confirmación de entrega del proveedor. Una respuesta plausible sin uso de herramientas ni fuente no es una prueba de conexión.

Lee la documentación con cualquier IA, sin MCP

No necesitas conectar MCP para leer la documentación de Bridge. Dale a un asistente que pueda abrir URLs el índice trilingüe de documentación y elige las fuentes para tu tarea e idioma: El índice enlaza a las páginas .md individuales y a los archivos OpenAPI exactos. La colección completa incluye los tres idiomas; la colección de un solo idioma es más pequeña. Las descripciones de endpoints reunidas no sustituyen los esquemas completos de OpenAPI. Los archivos por idioma usan JSON: el índice enumera las URLs y cada colección contiene el texto de las páginas como Markdown en su campo contentMarkdown. Los archivos generales llms.txt y llms-full.txt mantienen el formato Markdown. Ejemplo de prompt:
Lee https://docs.bridge.new/llms.txt y elige las fuentes en español para enviar un PDF. Lee la guía completa de adjuntos y el OpenAPI REST enlazado antes de escribir código. Explica la secuencia de carga, los campos obligatorios y las limitaciones de entrega. Conserva las firmas publicadas de la API y cita las URLs que leíste. Prepara solo el código; no hagas solicitudes reales.
Si buscas mediante MCP, especifica language: "es" para español, language: "pt-BR" para portugués o language: "en" para inglés. Las páginas públicas usan .md; las lecturas de páginas en el filesystem MCP usan .mdx. Consulta también la guía de capacidades y fuentes de Bridge.

Implementa con el contrato correcto

El servidor permite buscar documentación, leer páginas y esquemas completos en un sistema de archivos virtual de documentación y, opcionalmente, enviar comentarios. La herramienta de archivos no ejecuta comandos en tu equipo. Los comentarios son una función separada de la búsqueda y lectura: úsala solo cuando realmente quieras enviar un comentario sobre la documentación. Indica al asistente la tarea y el flujo correspondiente: El índice de documentación permite encontrar las páginas. La documentación reunida agrupa guías y descripciones de endpoints, pero no incluye todos los esquemas. Antes de generar código, lee el Markdown del endpoint individual o el OpenAPI REST o OpenAPI de Custom Connections que corresponda. Pídele al asistente que conserve hosts, métodos, rutas, autenticación, identificadores, nombres de campos, tipos, campos obligatorios y que admiten null, enums, valores predeterminados, límites y códigos de respuesta. Si las fuentes publicadas se contradicen, identifica los fragmentos y confirma el comportamiento actual antes de basarte en ellos.

Si no aparece el servidor

Las interfaces de los clientes cambian con el tiempo. Las opciones pueden variar según la versión y las políticas de la organización; consulta la documentación del proveedor enlazada si tus menús son distintos. Instrucciones de proveedores verificadas por última vez: 14 de noviembre de 2026.