Documentación · conector MCP
Conecta tus aplicaciones de IA a tu conocimiento de Bayan Flow
Busca el conocimiento de tu empresa, escribe y actualiza documentos, y revisa tu espacio de trabajo desde Claude, ChatGPT o cualquier aplicación MCP. Inicias sesión con tu cuenta de Bayan Flow, eliges lo que la aplicación puede hacer y mantienes el control.
- OAuth 2.0 con PKCE
- MCP remoto · HTTP transmitible
- Aprobación del propietario para cambios riesgosos
Dirección del servidor
https://bayanflow.tech/api/v1/mcpPegue esta dirección en su aplicación de IA como un conector MCP personalizado. No hay nada más que copiar.
Qué pueden hacer las aplicaciones de IA con Bayan Flow
Bayan Flow convierte los propios documentos de una empresa en respuestas precisas para su equipo de soporte. Este conector MCP permite que aplicaciones de IA como Claude y ChatGPT trabajen con las bases de conocimiento y el espacio de trabajo que elija, con tus permisos y nada más.
Responde desde tus propios documentos
La aplicación busca en las bases de conocimientos que permitas y lee los fragmentos, de modo que sus respuestas provienen de tus políticas e información de productos en lugar de suposiciones.
Mantén el conocimiento actualizado
Crea bases de conocimiento y documentos, y guarda las modificaciones como nuevas versiones. De esta forma nunca se elimina nada.
Comprende tu espacio de trabajo
Ver miembros (con correo enmascarado), equipos, uso y el registro de actividad. No se muestran datos de pagos ni secretos.
La aplicación propone, tú decides
La aplicación puede proponer añadir o eliminar miembros, cambiar roles, editar ajustes o eliminar conocimiento. Cada propuesta espera al propietario del espacio de trabajo, quien la aprueba en Bayan Flow con su contraseña.
Cosas que puedes pedirle a tu aplicación de IA
- Busca nuestra política de reembolsos en el conocimiento de Bayan Flow y resúmela en tres viñetas.
- ¿Qué documentos mencionan los tiempos de entrega? Enuméralos con la base de conocimientos en la que se encuentra cada uno.
- Crea un documento llamado “Lista de comprobación de devoluciones” en la base del Centro de ayuda con los pasos que acabamos de acordar.
- Muestra el uso de este mes y las últimas diez entradas del registro de actividad.
- Proponga eliminar al miembro que dejó la empresa. Lo aprobaré en Bayan Flow.
Conectar Claude en tres pasos
Esto es para Claude.ai y Claude Desktop. No hay una clave que copiar: inicia sesión en Bayan Flow y aprueba la conexión.
Necesita una cuenta de Bayan Flow que sea propietaria del espacio de trabajo, o un administrador a quien el propietario haya autorizado para gestionar integraciones. Los demás verán que no pueden conectar una aplicación y podrán preguntar al propietario.
Añade el conector en Claude
Abre Configuración → Conectores → Agregar conector personalizado, pega la dirección del servidor a continuación y guarda.
https://bayanflow.tech/api/v1/mcpPulsa Conectar
Se abrirá una página de Bayan Flow en tu navegador. Inicia sesión si se te solicita.
Selecciona el espacio de trabajo y los permisos
Elije el espacio de trabajo, marca lo que Claude puede hacer y pulsa Permitir. Cualquier acción más allá de la lectura solicita tu contraseña y volverás a Claude automáticamente.
Inicie un chat nuevo y pregunte: “Buscar en mi conocimiento de Bayan Flow la política de reembolso.”
Claude Code
Agrega el servidor, luego ejecuta /mcp dentro de Claude Code y selecciona Authenticate. Se abre la misma página de aprobación.
claude mcp add --transport http bayan-flow https://bayanflow.tech/api/v1/mcpClientes que no pueden abrir la página de inicio de sesión
Para Cursor, VS Code o un script, crea una clave de MCP en Integraciones → MCP y envíala como cabecera portadora. Guárdala en una variable de entorno, nunca en un archivo compartido.
Authorization: Bearer $BAYAN_MCP_KEYPara desconectar, abra Integraciones → MCP en Bayan Flow y revocar la conexión. La aplicación pierde el acceso de inmediato.
ChatGPT y otras aplicaciones de IA
Cualquier aplicación que admita servidores MCP remotos sobre HTTPS puede conectarse. Las aplicaciones que ofrecen inicio de sesión OAuth utilizan el mismo flujo de un solo enlace que Claude. Los nombres de los menús varían entre aplicaciones y cambian con el tiempo: busque “conector personalizado”, “modo desarrollador” o “añadir servidor MCP”.
ChatGPT
Disponible en los planes pagos de ChatGPT que permiten conectores MCP personalizados. En un espacio de trabajo empresarial, un administrador puede tener que habilitarlo primero.
- En la configuración de ChatGPT, activa el modo de desarrollador (búscalo en Conectores o Seguridad).
- Crea un nuevo conector (o aplicación): pega la dirección del servidor y elige OAuth como método de autenticación. No se requiere un Client ID ni un secreto, ya que ChatGPT se registra automáticamente.
- Pulsa Conectar. Se abrirá una página de Bayan Flow: elige el espacio de trabajo y los permisos, y luego pulsa Permitir.
https://bayanflow.tech/api/v1/mcpOtras aplicaciones con OAuth
Pega la dirección del servidor y deja la autenticación en OAuth o automática. La aplicación se registra y te dirige a la página de aprobación de Bayan Flow.
Aplicaciones que sólo ejecutan servidores locales
Usa el asistente mcp-remote (requiere Node.js), que convierte un servidor remoto en uno local. Los fragmentos listos para usar están en Integraciones → MCP.
Aplicaciones que usan una clave
Cursor, VS Code, Windsurf, Gemini CLI, Codex CLI y herramientas similares aceptan un encabezado personalizado. Crea una clave MCP en Integraciones → MCP y guárdala en una variable de entorno. Los nombres de configuración difieren ligeramente entre aplicaciones; lo que importa es la dirección y el encabezado.
{
"mcpServers": {
"bayan-flow": {
"url": "https://bayanflow.tech/api/v1/mcp",
"headers": { "Authorization": "Bearer ${BAYAN_MCP_KEY}" }
}
}
}La página de aprobación muestra el nombre de la aplicación y la dirección a la que devolverá. Las aplicaciones de Anthropic y OpenAI están marcadas como verificadas; para cualquier otra aplicación, verifica la dirección antes de permitir.
Herramientas
25 herramientas, todas listadas a continuación. Cada una tiene un título y se indica si es de solo lectura o no, de modo que la aplicación y sus usuarios puedan saber qué hace una herramienta antes de ejecutarla.
LecturaHerramientas de solo lectura
No se modifica nada y no se consumen créditos.
knowledge_list_basesknowledge:readMuestra las bases de conocimiento que esta clave puede leer, con su nivel de acceso y recuento de documentos.
knowledge_searchknowledge:readBusca en tu conocimiento y devuelve los mejores fragmentos con sus fuentes. Sólo recuperación: sin texto IA, sin créditos.
knowledge_list_documentsknowledge:readMuestra la lista de documentos de una base de conocimiento.
knowledge_get_documentknowledge:readLee el texto de un documento, página por página.
workspace_getworkspace:readNombre, idiomas, plan y uso de asientos del espacio de trabajo.
workspace_list_membersworkspace:readMiembros con su rol y estado. Las direcciones de correo electrónico están ocultas.
workspace_list_teamsworkspace:readEquipos y cuántos miembros tiene cada uno.
workspace_usageworkspace:readTotales de solicitudes, créditos y actividad de los últimos días.
workspace_audit_logworkspace:readEntradas recientes del registro de actividad: quién hizo qué, nunca el contenido.
workspace_list_pending_actionsworkspace:readLos cambios de claves propuestos y su resultado.
store_order_statusworkspace:readEl estado de un pedido de la tienda conectada: envío, seguimiento, artículos y total. Nunca los datos del cliente.
EscriturasHerramientas que escriben conocimiento
Crean o editan conocimiento. Las ediciones se guardan como nuevas versiones y no se elimina nada.
knowledge_create_baseknowledge:writeCrea una base de conocimiento de empresa. No válido para claves limitadas a bases seleccionadas.
knowledge_create_documentknowledge:writeAñade un nuevo documento a una base de conocimiento. Se indexa en segundo plano.
knowledge_update_documentknowledge:writeGuarda el texto nuevo como una versión nueva. Las versiones anteriores se conservan, no se elimina nada.
Requiere aprobaciónHerramientas que proponen cambios
Ellos nunca cambian nada por sí mismos. Crean una propuesta que el propietario del espacio de trabajo aprueba o rechaza en Bayan Flow.
knowledge_delete_documentworkspace:adminPropone eliminar un documento. No se elimina nada hasta que el propietario lo aprueba.
knowledge_archive_baseworkspace:adminPropone archivar una base de conocimiento para que deje de ofrecer respuestas.
member_inviteworkspace:adminPropone invitar a una persona por correo electrónico. Se envía solo tras la aprobación.
member_change_roleworkspace:adminPropone cambiar el rol de un miembro a administrador o miembro. Nunca al propietario.
member_disableworkspace:adminPropone desactivar a un miembro: perderá el acceso y la licencia quedará libre.
member_removeworkspace:adminPropone eliminar a un miembro del espacio de trabajo.
team_createworkspace:adminPropone crear un equipo.
team_updateworkspace:adminPropone cambiar el nombre de un equipo o modificar su descripción.
team_deleteworkspace:adminPropone eliminar un equipo.
team_set_membersworkspace:adminPropone reemplazar la lista de miembros de un equipo.
workspace_update_settingsworkspace:adminPropone cambiar el nombre, los idiomas o lo que pueden hacer los administradores. Nunca las integraciones ni la facturación.
La aplicación solo ve las herramientas que tus permisos permiten. Si falta alguna herramienta, vuelve a conectarte y marca más permisos.
Permisos
Los seleccionas en la página de aprobación. Una conexión nunca puede hacer más de lo que marcaste, y puedes revocarla en cualquier momento.
Leer conocimiento
knowledge:readBuscar y leer las bases de conocimiento que la clave puede utilizar. No se cambia nada ni se gastan créditos.
Un clic para permitir.
Escribir conocimiento
knowledge:writeCrear bases de conocimiento y documentos, y guardar ediciones como nuevas versiones. Nunca elimina nada.
Solicita su contraseña.
Leer el espacio de trabajo
workspace:readVer miembros (nombres, roles, correo electrónico oculto), equipos, uso y el registro de actividad. Sin secretos ni datos de pago.
Un clic para permitir.
Proponer cambios en el espacio de trabajo
workspace:adminProponer cambios a miembros, equipos, configuración y eliminaciones de conocimiento. Cada uno espera la aprobación del propietario.
Solo para propietarios de espacios de trabajo, solicita su contraseña y cada cambio sigue requiriendo la aprobación del propietario.
Seguridad y privacidad
El conector está diseñado para que un error, un token filtrado o un asistente que actúa mal tengan un impacto limitado.
Inicio de sesión bajo tu control
Código de autorización OAuth 2.0 con PKCE. La aplicación nunca ve tu contraseña y Bayan Flow nunca ve las credenciales de la aplicación. La página de aprobación muestra el nombre de la aplicación y la dirección a la que retornará.
Solo lo que tú permitas
Una conexión está limitada a un espacio de trabajo y a los permisos que hayas seleccionado. La persona que la aprobó debe seguir gestionando las integraciones allí, o la conexión se detendrá.
Aprobación del propietario
Los cambios de riesgo son solo propuestas. El propietario los aprueba con su contraseña; 5 intentos erróneos bloquean la aprobación durante 15 minutos, y una propuesta que nadie decida caduca tras 24 horas.
Acceso de corta duración
Los tokens de acceso duran una hora y se renuevan automáticamente. Si se usa una copia de un token de renovación una segunda vez, se cancela toda la conexión.
Revócalo en cualquier momento
Revoca la conexión desde Integraciones → MCP, o desde la aplicación. Las propuestas pendientes se rechazarán y el acceso se detendrá de inmediato.
Un registro de auditoría
Bayan Flow registra qué herramienta se llamó y cómo terminó, nunca el contenido. Los propietarios del espacio de trabajo también reciben un correo electrónico cuando se establece una conexión.
Sus datos
Los fragmentos que la aplicación solicita se envían al proveedor de esa aplicación y se manejan bajo los términos de su plan con ellos, por lo que conecte solo a los asistentes de los que su empresa confía. El texto de sus documentos se marca como datos, no como instrucciones, para resistir la inyección de prompts. Bayan Flow ve las llamadas a la herramienta que hace la aplicación, no su conversación con ella.
Nunca posible a través de MCP, sin importar lo que permita
- Eliminación del espacio de trabajo
- Transferir la propiedad o cambiar de propietario
- Contraseñas, sesiones, verificación en dos pasos y inicio de sesión
- Crear, listar o revocar claves de API
- Activar o desactivar integraciones, o elegir quién las gestiona
- Planes, puestos, métodos de pago, facturas y reembolsos
- Exportación de datos personales
- Cualquier aspecto a nivel de la plataforma Bayan
- Cualquier elemento de otro espacio de trabajo
Lee nuestro Política de Privacidad · Términos de servicio
Solución de problemas
El botón Permitir está deshabilitado
Elija primero un espacio de trabajo. Si tiene más de uno, ninguno se selecciona automáticamente. Una línea sobre el botón indica lo que falta.
No aparece ningún espacio de trabajo en la página de aprobación
Solo los propietarios del espacio de trabajo y los administradores a los que el propietario permita gestionar integraciones pueden conectar una aplicación. Pide al propietario que la conecte o que te dé ese permiso.
La página indica que la integración está desactivada
Bayan Flow desactivó MCP para ese espacio de trabajo. Ponte en contacto con el soporte desde la página de contacto.
La aplicación indica que la conexión ha expirado o necesita iniciar sesión de nuevo
Las conexiones se renuevan automáticamente mientras se usan. Después de un año, o si se revocó la conexión, presione Conectar de nuevo en la aplicación.
¿Por qué me pidió mi contraseña?
Cualquier acción más allá de leer solicita su contraseña, igual que crear una clave API. Si inicia sesión únicamente con Google, establezca primero una contraseña en Configuración → Seguridad.
Falta una herramienta que esperaba
La aplicación solo ve las herramientas que tus permisos permiten. Conéctate de nuevo y marca más permisos.
La aplicación reporta demasiadas solicitudes
Cada conexión permite 120 llamadas a la herramienta y 30 escrituras por minuto. Espere un momento y vuelva a intentarlo.
El espacio de trabajo ya tiene el número máximo de conexiones.
Un espacio de trabajo puede tener cinco conexiones MCP al mismo tiempo. Revocar la que ya no use en Integraciones → MCP.
¿Aún atascado? Escríbenos desde el página de contacto
Referencia técnica
Para desarrolladores y revisores que verifican la conexión.
- Dirección del servidor
- https://bayanflow.tech/api/v1/mcp
- Transporte
- HTTP transmisible, sin estado: solo POST, sin sesiones y sin flujo de eventos.
- Versiones del protocolo MCP
- 2025-11-25, 2025-06-18, 2025-03-26
- Autorización
- Código de autorización OAuth 2.0 con PKCE (S256), clientes públicos, registro dinámico de clientes (RFC 7591), descubrimiento por RFC 9728 y RFC 8414.
- Metadatos del recurso protegido
- https://bayanflow.tech/.well-known/oauth-protected-resource/api/v1/mcp
- Metadatos del servidor de autorización
- https://bayanflow.tech/.well-known/oauth-authorization-server
- Endpoint de autorización
- https://bayanflow.tech/oauth/authorize
- Endpoint de token
- https://bayanflow.tech/api/oauth/token
- Registro de clientes
- https://bayanflow.tech/api/oauth/register
- Punto de revocación
- https://bayanflow.tech/api/oauth/revoke
- Tokens
- Token de acceso de una hora. El token de actualización rota en cada uso: 60 días desde el último uso, un año como máximo. El token de actualización anterior deja de ser válido.
- Ámbitos
- knowledge:read, knowledge:write, workspace:read, workspace:admin
- Límites
- Por conexión: 120 llamadas a herramientas y 30 escrituras por minuto. Una respuesta se corta en 100 KB.
¿Listo para conectar?
Crea un espacio de trabajo o inicia sesión, luego sigue los tres pasos anteriores.

