Waafir
Esta página es una traducción automática pendiente de revisión humana. Puede contener errores.

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

Complementos → 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/waafir

Despué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"
    }
  }
}

(Guía de Cursor)

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

Despué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 waafir

(Guía de Codex)

Conectarse 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:

ServidorURL
waafir-redacthttps://app.waafir.io/api/mcp/waafir-redact
waafir-translatehttps://app.waafir.io/api/mcp/waafir-translate
waafir-dataroomhttps://app.waafir.io/api/mcp/waafir-dataroom
waafir-esignhttps://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-dataroom o waafir-esign — casi siempre una errata o un /api/mcp sin 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. waafir nunca responde 402: en su lugar oculta las herramientas de pago, y una llamada a una de ellas se rechaza en la capa 2 con QUOTA_EXCEEDED y un mensaje que nombra esa herramienta, que también incluye ADDON_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 Authorization está 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 403 CSRF validation failed: missing Origin en 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-After ni 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ódigoSignificado
INVALID_ARGUMENTFalta un argumento, está mal formado o no es un id válido — corríjalo y reintente
FORBIDDENEl token es válido, pero no está autorizado para esta llamada
NOT_FOUNDNo existe ese registro, o no es suyo
CONFLICTSe entendió y está permitido, pero la sala de datos no está en un estado en el que pueda llevarse a cabo
TOO_LARGELa entrada supera un límite de tamaño — divídala
QUOTA_EXCEEDEDSe ha agotado una asignación medida; alguien debe comprar o ampliar algo
UPSTREAM_ERROR / UNAVAILABLEUn fallo transitorio en un servicio posterior — reintente más tarde
INTERNALUn fallo inesperado — no reintente, escálelo

Dos de ellos suelen confundir:

  • FORBIDDEN por un alcance insuficiente. A una conexión o un token read no 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í como FORBIDDEN en el contenido — no como un HTTP 403. Lo mismo ocurre con un token restringido a salas de datos concretas que indica como dataroom_id una fuera de su lista permitida. La mayoría de las herramientas que reciben un id de archivo o de carpeta responden en cambio NOT_FOUND para 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ó. Un CONFLICT no 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 de waafir-dataroom lista 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ó.