Saltar al contenido

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/mcp

Pegue 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.

  1. 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/mcp
  2. Pulsa Conectar

    Se abrirá una página de Bayan Flow en tu navegador. Inicia sesión si se te solicita.

  3. 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/mcp

Clientes 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_KEY

Para 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.

  1. En la configuración de ChatGPT, activa el modo de desarrollador (búscalo en Conectores o Seguridad).
  2. 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.
  3. 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/mcp

Otras 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:read

    Muestra las bases de conocimiento que esta clave puede leer, con su nivel de acceso y recuento de documentos.

  • knowledge_searchknowledge:read

    Busca en tu conocimiento y devuelve los mejores fragmentos con sus fuentes. Sólo recuperación: sin texto IA, sin créditos.

  • knowledge_list_documentsknowledge:read

    Muestra la lista de documentos de una base de conocimiento.

  • knowledge_get_documentknowledge:read

    Lee el texto de un documento, página por página.

  • workspace_getworkspace:read

    Nombre, idiomas, plan y uso de asientos del espacio de trabajo.

  • workspace_list_membersworkspace:read

    Miembros con su rol y estado. Las direcciones de correo electrónico están ocultas.

  • workspace_list_teamsworkspace:read

    Equipos y cuántos miembros tiene cada uno.

  • workspace_usageworkspace:read

    Totales de solicitudes, créditos y actividad de los últimos días.

  • workspace_audit_logworkspace:read

    Entradas recientes del registro de actividad: quién hizo qué, nunca el contenido.

  • workspace_list_pending_actionsworkspace:read

    Los cambios de claves propuestos y su resultado.

  • store_order_statusworkspace:read

    El 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:write

    Crea una base de conocimiento de empresa. No válido para claves limitadas a bases seleccionadas.

  • knowledge_create_documentknowledge:write

    Añade un nuevo documento a una base de conocimiento. Se indexa en segundo plano.

  • knowledge_update_documentknowledge:write

    Guarda 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:admin

    Propone eliminar un documento. No se elimina nada hasta que el propietario lo aprueba.

  • knowledge_archive_baseworkspace:admin

    Propone archivar una base de conocimiento para que deje de ofrecer respuestas.

  • member_inviteworkspace:admin

    Propone invitar a una persona por correo electrónico. Se envía solo tras la aprobación.

  • member_change_roleworkspace:admin

    Propone cambiar el rol de un miembro a administrador o miembro. Nunca al propietario.

  • member_disableworkspace:admin

    Propone desactivar a un miembro: perderá el acceso y la licencia quedará libre.

  • member_removeworkspace:admin

    Propone eliminar a un miembro del espacio de trabajo.

  • team_createworkspace:admin

    Propone crear un equipo.

  • team_updateworkspace:admin

    Propone cambiar el nombre de un equipo o modificar su descripción.

  • team_deleteworkspace:admin

    Propone eliminar un equipo.

  • team_set_membersworkspace:admin

    Propone reemplazar la lista de miembros de un equipo.

  • workspace_update_settingsworkspace:admin

    Propone 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:read

    Buscar 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:write

    Crear bases de conocimiento y documentos, y guardar ediciones como nuevas versiones. Nunca elimina nada.

    Solicita su contraseña.

  • Leer el espacio de trabajo

    workspace:read

    Ver 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:admin

    Proponer 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.

Conector MCP para Claude, ChatGPT y aplicaciones de IA · Bayan Flow