Configuración
Conectar un asistente de IA a Waafir solo requiere una URL: péguela en su asistente y, cuando se lo pida, inicie sesión en Waafir. No hay ningún token que crear ni copiar. Esta página explica el inicio de sesión, el paso de añadir servidor de cada asistente y cómo conectarse con un token de acceso personal en su lugar cuando un asistente no puede iniciar sesión.
Lo básico
La URL. Una sola URL sirve todas las herramientas de Waafir:
https://app.waafir.io/api/mcp/waafirComplementos → Configuración → Asistentes de IA muestra la URL de su
despliegue, con un botón para copiarla. Sustituya https://app.waafir.io si
utiliza otro despliegue.
Inicio de sesión. La primera vez que su asistente usa la URL, abre Waafir en su navegador. Inicie sesión como lo hace normalmente y revise la pantalla de consentimiento:
- En qué organización trabaja el asistente, si usted pertenece a más de una;
- A qué salas de datos puede acceder: a todas o solo a las que usted elija;
- Qué puede hacer: lectura, escritura o administración, nunca más de lo que permite su propio rol, y si puede firmar documentos o enviar fuera de su organización;
- Confirme que es usted. Si ha configurado la autenticación de dos factores, cada aprobación le pide primero su código, igual que al crear un token.
Apruebe, y el navegador le devuelve al asistente. La conexión aparece en Complementos → Configuración → Asistentes de IA, donde puede ver a qué puede acceder y revocarla. Consulte Conexiones.
Unverified app "…". Un asistente que se identifica mediante una dirección
web que controla se muestra con esa dirección, como claude.ai. Uno que se
registró por sí mismo con un nombre elegido por él se muestra como
Unverified app "<its name>": Waafir no puede confirmar quién lo creó, así que
apruébelo solo si usted mismo inició la conexión.
Qué muestra la lista de herramientas. Los nombres de las herramientas
empiezan por su área: dataroom_, esign_, redact_ y translate_. La lista
muestra solo las herramientas que su conexión y su organización pueden usar: a
una conexión de solo lectura no se le muestran las herramientas de escritura, y
las herramientas de firma electrónica solo aparecen si su organización tiene el
complemento E-Signatures o una suscripción activa. Una conexión también lista
las herramientas que requieren un permiso que usted no concedió, como firmar o
enviar fuera de su organización. Si el asistente llama a una de ellas, Waafir
rechaza la llamada y el asistente le pide que apruebe de nuevo, esta vez con
ese permiso ofrecido. Un token no puede volver a pedirlo, por lo que su lista
omite esas herramientas. Una herramienta que no figura en la lista se sigue
rechazando, indicando el motivo, si un asistente la llama de todos modos.
Conectar su asistente
Cada sección siguiente indica el paso de añadir servidor propio de cada asistente y enlaza a su documentación (cada enlace se comprobó por última vez el 23 de octubre de 2026). Ninguno de estos asistentes se ha probado todavía con el inicio de sesión de Waafir, por lo que cada sección mantiene al lado la alternativa del token.
Claude (claude.ai y Claude Desktop)
Aún no probado por Waafir. Abra Customize → Connectors, elija Add → Add custom connector, asígnele un nombre, pegue la URL y continúe. Deje activado el inicio de sesión e inicie sesión en Waafir cuando Claude se lo pida. Para usarlo en un chat, actívelo en + → Connectors. En un plan Team o Enterprise, un propietario añade los conectores en Organization settings → Connectors. (Guía de Claude)
Si el inicio de sesión no funciona, añada en su lugar una cabecera de solicitud
Authorization: Bearer <token> con un token (consulte
Conectarse con un token en su lugar).
ChatGPT
Aún no probado por Waafir. ChatGPT accede a los servidores MCP remotos desde lugares distintos según la aplicación; en la aplicación de escritorio, abra Settings → MCP servers → Add server y pegue la URL, y después inicie sesión en Waafir cuando se le pida. (Guía de OpenAI)
Si ChatGPT no puede iniciar sesión, use un token en su lugar.
Claude Code
Aún no probado por Waafir.
claude mcp add --transport http waafir https://app.waafir.io/api/mcp/waafirDespués ejecute /mcp dentro de Claude Code (o claude mcp login waafir desde
su shell) e inicie sesión en Waafir en el navegador. Añada --scope user para
usarlo en todos los proyectos. Complementos → Configuración → Asistentes de IA tiene este comando listo para copiar.
(Guía de Claude Code)
Cursor
Aún no probado por Waafir. Añada la URL a .cursor/mcp.json (o a
~/.cursor/mcp.json para todos los proyectos) y después inicie sesión en
Waafir cuando Cursor se lo pida:
{
"mcpServers": {
"waafir": {
"url": "https://app.waafir.io/api/mcp/waafir"
}
}
}Si Cursor no puede iniciar sesión, añada la cabecera del token que se muestra en Conectarse con un token en su lugar.
VS Code
Aún no probado por Waafir. Ejecute MCP: Add Server desde la paleta de
comandos, elija HTTP, pegue la URL y asígnele el id waafir. Inicie sesión
en Waafir cuando VS Code se lo pida.
(Guía de VS Code)
Gemini CLI
Aún no probado por Waafir.
gemini mcp add --transport http waafir https://app.waafir.io/api/mcp/waafirDespués ejecute /mcp auth waafir e inicie sesión en el navegador. El inicio
de sesión requiere un navegador local, por lo que no funciona en la mayoría de
las sesiones SSH remotas: use un token en ese caso.
(Guía de Gemini CLI)
Codex
Aún no probado por Waafir.
codex mcp add waafir --url https://app.waafir.io/api/mcp/waafir
codex mcp login waafirConectarse con un token en su lugar
Use un token de acceso personal
cuando un asistente no pueda iniciar sesión, o para un script. Cada solicitud
lleva el token como bearer token en la cabecera Authorization:
Authorization: Bearer waafir_pat_...Nunca incluya un token real en un archivo o repositorio compartido; trátelo como una contraseña. Complementos → Configuración → Tokens API tiene un fragmento listo para copiar.
Servidores de área. Además de waafir, se siguen sirviendo cuatro
servidores de área, para que una configuración existente siga funcionando.
Cada uno lista solo las herramientas de su propia área, filtradas del mismo
modo, y conserva los nombres de herramienta que siempre ha tenido
(list_files en lugar de dataroom_list_files). No los necesita si se conecta
a waafir:
| Servidor | URL |
|---|---|
waafir-redact | https://app.waafir.io/api/mcp/waafir-redact |
waafir-translate | https://app.waafir.io/api/mcp/waafir-translate |
waafir-dataroom | https://app.waafir.io/api/mcp/waafir-dataroom |
waafir-esign | https://app.waafir.io/api/mcp/waafir-esign |
No existe un endpoint /api/mcp sin más: el segmento con el nombre del
servidor es obligatorio, y una solicitud sin él devuelve un 404.
waafir-esign es una oferta de pago: sin el
complemento E-Signatures ni una suscripción activa, su URL responde con un
error ADDON_NOT_PURCHASED. En waafir, esa misma organización simplemente no
ve las herramientas esign_.
Claude Code. Ponga primero el token en una variable de entorno, para que no quede en el historial de su shell:
export WAAFIR_PAT=... # the token you copied at issuance
claude mcp add --transport http waafir https://app.waafir.io/api/mcp/waafir \
--header "Authorization: Bearer $WAAFIR_PAT"Para compartir la configuración con un proyecto, ponga la misma entrada en su
.mcp.json. Claude Code expande ${WAAFIR_PAT} a partir del entorno de cada
persona, por lo que el archivo se puede subir al repositorio sin el token:
{
"mcpServers": {
"waafir": {
"type": "http",
"url": "https://app.waafir.io/api/mcp/waafir",
"headers": {
"Authorization": "Bearer ${WAAFIR_PAT}"
}
}
}
}El archivo de configuración de Claude Desktop. claude_desktop_config.json
inicia servidores locales: cada entrada es un command que ejecutar, no
una url remota. Para llegar a Waafir desde ese archivo, ejecute el puente
mcp-remote (requiere Node.js),
que reenvía al servidor remoto y añade su token como cabecera:
{
"mcpServers": {
"waafir": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.waafir.io/api/mcp/waafir",
"--header",
"Authorization:${WAAFIR_AUTH}"
],
"env": {
"WAAFIR_AUTH": "Bearer YOUR_WAAFIR_PAT"
}
}
}
}Mantenga el argumento Authorization:${WAAFIR_AUTH} sin espacios y después
reinicie Claude Desktop.
Cursor y otros clientes que aceptan una URL y cabeceras.
{
"mcpServers": {
"waafir": {
"url": "https://app.waafir.io/api/mcp/waafir",
"headers": {
"Authorization": "Bearer YOUR_WAAFIR_PAT"
}
}
}
}Un servidor de área se añade del mismo modo, cambiando la clave de la entrada y la URL.
Llamar a una herramienta
Tras conectarse, su cliente lista las herramientas del servidor (un
tools/list de MCP) y las llama en su nombre. Usted no llama a las
herramientas a mano: pide al cliente de IA que haga algo ("lista los archivos
de esta sala de datos", "traduce este párrafo al francés") y este selecciona y
llama a la herramienta adecuada, pasando los argumentos documentados en la
referencia de cada servidor. Consulte las referencias de
waafir-redact,
waafir-translate,
waafir-dataroom y
waafir-esign para ver los contratos de las
herramientas.
Cuando algo falla
Los fallos llegan en dos capas distintas, y no se parecen. Confundirlas es el error de integración más habitual aquí: un cliente que solo se guía por el código de estado HTTP pasará por alto, sin aviso, todos los fallos del segundo tipo.
Capa 1 — la solicitud se rechazó antes de que se ejecutara ninguna herramienta
Son códigos de estado de error HTTP reales, con un cuerpo de error con forma de JSON-RPC. Significan que la solicitud nunca llegó a ninguna herramienta:
-
404 — Servidor MCP desconocido. El segmento con el nombre del servidor en la URL no es ninguno de
waafir,waafir-redact,waafir-translate,waafir-dataroomowaafir-esign— casi siempre una errata o un/api/mcpsin nombre de servidor. Corrija la URL. -
402 — Complemento no adquirido. El servidor es una oferta de pago (hoy:
waafir-esign) y su organización no tiene ni el complemento ni una suscripción activa. Un administrador de la organización puede adquirir el complemento o un plan desde la configuración de facturación. Una organización sin derecho de uso ni siquiera puede listar las herramientas del servidor.waafirnunca responde 402: en su lugar oculta las herramientas de pago, y una llamada a una de ellas se rechaza en la capa 2 conQUOTA_EXCEEDEDy un mensaje que nombra esa herramienta, que también incluyeADDON_NOT_PURCHASED. -
401 — No autenticado. La credencial falta, está mal formada, se ha revocado o ha vencido. Para una conexión, inicie sesión de nuevo desde su asistente: la mayoría de los asistentes lo hacen por usted cuando ven el 401, y una conexión que se revocó, o que no se usó durante 30 días, necesita un nuevo inicio de sesión. Para un token, compruebe que la cabecera
Authorizationestá presente y que el token sigue activo en Complementos → Configuración → Tokens API; emita uno nuevo si se ha revocado o ha vencido. Un despliegue anterior a este comportamiento responde a un token ausente o mal formado con 403CSRF validation failed: missing Originen su lugar; en esta superficie, eso también significa que el token falta o está mal formado. -
403 — Prohibido. La credencial se rechazó en la entrada: se usó una sesión de navegador iniciada en lugar de una conexión o un PAT (las sesiones no se aceptan en esta superficie), o su organización aplica una lista de IP permitidas y la solicitud procedía de una dirección fuera de ella.
-
429 — Demasiadas solicitudes. Ha alcanzado un límite de frecuencia de MCP. Nada aquí depende de su dirección IP ni de su organización — su cupo es el de su token, de modo que un colega de la misma organización y un segundo cliente en la misma red no lo consumen. El límite es de 60 solicitudes por minuto por token. Se contabiliza antes de buscar el token, así que un token mal formado, revocado o vencido también lo consume, y las llamadas del mismo token a la API de Waafir fuera de MCP cuentan contra los mismos 60. Los 60 de una conexión con sesión iniciada también se cuentan por conexión, por lo que el token nuevo que obtiene su asistente al renovar su inicio de sesión no empieza unos 60 nuevos.
La respuesta no incluye cabecera
Retry-Afterni ningún código distintivo — todos los 429 de esta superficie son iguales —, así que espere según una pauta propia en lugar de reintentar en bucle. Si un token no le da suficiente margen, emita un segundo: el límite es por token.
Capa 2 — una herramienta se ejecutó y se negó
Aquí es donde se producen la mayoría de los rechazos, y no es un error HTTP. La respuesta HTTP es 200 y el sobre JSON-RPC es un sobre de
éxito. El fallo viaja dentro del resultado de la herramienta, que establece
isError: true y cuyo contenido de texto es:
{ "error": { "code": "CONFLICT", "message": "…" } }Decida según error.code. Los códigos son:
| Código | Significado |
|---|---|
INVALID_ARGUMENT | Falta un argumento, está mal formado o no es un id válido — corríjalo y reintente |
FORBIDDEN | El token es válido, pero no está autorizado para esta llamada |
NOT_FOUND | No existe ese registro, o no es suyo |
CONFLICT | Se entendió y está permitido, pero la sala de datos no está en un estado en el que pueda llevarse a cabo |
TOO_LARGE | La entrada supera un límite de tamaño — divídala |
QUOTA_EXCEEDED | Se ha agotado una asignación medida; alguien debe comprar o ampliar algo |
UPSTREAM_ERROR / UNAVAILABLE | Un fallo transitorio en un servicio posterior — reintente más tarde |
INTERNAL | Un fallo inesperado — no reintente, escálelo |
Dos de ellos suelen confundir:
FORBIDDENpor un alcance insuficiente. A una conexión o un tokenreadno se le muestran las herramientas de escritura, pero un cliente que llama a una de todos modos recibe el rechazo de la herramienta, por lo que llega aquí comoFORBIDDENen el contenido — no como un HTTP 403. Lo mismo ocurre con un token restringido a salas de datos concretas que indica comodataroom_iduna fuera de su lista permitida. La mayoría de las herramientas que reciben un id de archivo o de carpeta responden en cambioNOT_FOUNDpara un elemento de esa sala, exactamente igual que para un id que no existe. Inicie sesión de nuevo desde su asistente y conceda el alcance o las salas de datos correctos, o emita un token con el alcance adecuado.CONFLICT. La llamada se entendió y está permitida, pero la sala de datos no está en un estado en el que pueda llevarse a cabo — un nombre de carpeta ya ocupado, un archivo cuyo nombre ha reclamado después un archivo activo, o una restauración cuyo contenedor sigue eliminado o cuya carga nunca se completó. UnCONFLICTno es un problema de autorización, y volver a iniciar sesión o volver a emitir el token no ayudará; el mensaje nombra el registro que lo bloquea cuando existe, para que pueda actuar sobre él y reintentar. La referencia dewaafir-dataroomlista los conflictos que puede devolver cada herramienta.
Un archivo que aún se está comprobando. Waafir comprueba cada archivo recién
subido y cada nueva versión antes de servir su contenido. Hasta entonces, una
herramienta que lee el contenido del archivo responde UNAVAILABLE con
error.reason: "ACTIVATION_PENDING" y el mensaje
This file is still being checked. Try again shortly. Es transitorio: vuelva a
llamar tras una breve espera.
Un rechazo claro en cualquiera de las dos capas es el resultado esperado y seguro de una llamada que Waafir no atenderá: falla la solicitud en lugar de hacer en silencio menos de lo que usted pidió.