Saltar al contenido principal
Los toolsets permiten que una conexión MCP de Didit cargue una lista corta de herramientas en lugar de todo el catálogo, y el modo de solo lectura te da una conexión que nunca puede modificar datos. Ambos se configuran como un parámetro en la URL del servidor:
Sin ningún parámetro, el servidor enumera todas las herramientas que tu rol puede usar, así que nada cambia en una conexión que ya tienes.

Por qué cargar menos herramientas

Tu cliente envía la definición de cada herramienta listada al modelo antes de tu primera pregunta. Para el catálogo completo de Didit, eso son decenas de miles de tokens en cada solicitud: entre 50 000 y 115 000, según el tokenizador del modelo. Algunos clientes también limitan cuántas herramientas aceptan. La contrapartida es un paso adicional. Una herramienta fuera de la lista no se pierde, pero el modelo tiene que encontrarla con búsqueda de herramientas antes de poder ejecutarla, y un modelo que ve todas las herramientas elige la correcta algo más a menudo que un modelo que tiene que buscarlas. Carga todo cuando una conversación abarca muchas áreas y el coste de contexto no importa. Carga core, junto con los conjuntos de herramientas que más usas, cuando sí importa.

Elige tus conjuntos de herramientas

Añade toolsets a la URL del servidor con una lista separada por comas:
core es la lista corta de la que parte la mayoría del trabajo. Incluye tus organizaciones y aplicaciones, las sesiones de verificación (crear, buscar, decidir, explicar, simular en el sandbox y leer las entregas de webhook), la búsqueda de flujos de verificación (workflow), las analíticas y el saldo, la clave de API y los webhooks de tu aplicación, la búsqueda de casos, usuarios, empresas y transacciones, y la búsqueda en la documentación.
  • core: la lista corta descrita arriba.
  • account: organizaciones, aplicaciones, claves de API, miembros y roles.
  • billing: plan, saldo de créditos, métodos de pago, recibos y datos de facturación.
  • sessions: sesiones de verificación (crear, buscar, decidir, revisar, compartir, importar, PDF y entregas de webhook).
  • workflows: flujos de verificación y cuestionarios (crear, editar, validar y publicar).
  • lists: listas personalizadas, la lista de bloqueo y la lista de permitidos.
  • vendors: las personas y empresas que verificas (usuarios y empresas de proveedores).
  • transactions: monitorización de transacciones (transacciones, análisis de wallets y reglas con pruebas retrospectivas).
  • cases: gestión de casos (crear, asignar, escalar y resolver casos).
  • investigator: Investigator (su cola de revisión, informes, decisiones, preguntas sobre políticas y rendimiento).
  • webhooks: destinos de webhook y alertas.
  • reports: analíticas, exportaciones y registro de auditoría.
  • branding: marca blanca del flujo de verificación.
  • verification: APIs de verificación independientes (documento de identidad, rostro, AML, prueba de domicilio, teléfono, correo electrónico, validación de base de datos y verificaciones de empresas).
  • travel_rule: Travel Rule (ajustes, el directorio de VASP, redes, direcciones de wallet, transferencias y mensajes).
  • marketplace: el mercado de proveedores (el catálogo, tus conexiones y tus solicitudes de integración).
  • networks: redes de fraude (sesiones vinculadas, usuarios y empresas que comparten un dispositivo, un documento o un contacto).
  • compliance: el asistente de cumplimiento (tu perfil regulatorio, sus requisitos y los flujos generados a partir de ellos).
  • docs: búsqueda en la documentación de Didit.
  • all: todas las herramientas que tu rol puede usar. Es el valor predeterminado.
La referencia de herramientas enumera cada herramienta con su tipo y el permiso de rol que necesita. Así se comporta la selección:
  • Los toolsets son opcionales. Una URL sin toolsets lista todo.
  • Al indicar toolsets, se enumeran exactamente esos. ?toolsets=cases lista las herramientas de casos, además de didit_context_get, que se incluye en cada conexión. Añade core si quieres mantener también la lista corta.
  • Un toolset decide qué se lista, no qué puedes ejecutar. Una herramienta fuera de tu selección sigue ejecutándose cuando el modelo la invoca por nombre, con los mismos permisos de rol de siempre.
  • Un nombre que el servidor no conoce se ignora. La conexión sigue funcionando, y el servidor indica al modelo qué nombre ignoró y cuáles son válidos.
  • Tu rol sigue aplicando. Un toolset nunca concede un permiso: consulta roles y permisos.

Conectar en modo de solo lectura

Añade read_only=true a la URL del servidor:
Una conexión de solo lectura solo muestra las herramientas que leen datos, y el servidor rechaza cada llamada que cree, modifique o elimine algo. El rechazo se produce en el servidor en cada llamada, por lo que se mantiene aunque tu cliente recuerde una herramienta de una conexión anterior. Úsala para generar informes, para explorar una cuenta o para un agente que no quieras que actúe por su cuenta. Para volver a permitir cambios, conéctate sin read_only.

Acceder a las herramientas que no cargaste

Cuando una conexión lista solo una parte del catálogo, el servidor añade cuatro herramientas para que ninguna quede fuera de alcance:
  • didit_tool_search (lectura): encuentra herramientas según lo que quieres hacer (“exportar sesiones a CSV”), o lista un conjunto de herramientas. Cada coincidencia indica qué hace la herramienta, sus parámetros y si lee, escribe o es destructiva.
  • didit_tool_describe (lectura): devuelve la descripción completa y el esquema de entrada de hasta cinco herramientas.
  • didit_tool_call_read (lectura): ejecuta una herramienta de solo lectura que no está en la lista. Rechaza una herramienta que modifique datos.
  • didit_tool_call_write (destructiva): ejecuta una herramienta que crea, modifica o elimina datos y que no está en la lista. No se ofrece en una conexión de solo lectura.
Una llamada a través de didit_tool_call_read o didit_tool_call_write se verifica exactamente igual que una llamada directa: siguen aplicando los permisos de tu rol, el modo de solo lectura y todos los requisitos de confirm: true. Son dos herramientas separadas para que tu cliente pueda pedirte confirmación antes de un cambio y dejar pasar una consulta. Con core cargado, una solicitud como “invitar a un nuevo miembro a mi organización” sigue este proceso:
  1. El modelo llama a didit_tool_search con invite a teammate y obtiene didit_org_invite_member, marcada como de escritura.
  2. Llama a didit_tool_call_write, pasando didit_org_invite_member como name junto con los argumentos propios de esa herramienta.
  3. Tu cliente te pide que apruebes la llamada, como hace con cualquier herramienta que modifica datos.
Cuando todo está cargado no queda nada por descubrir, así que estas cuatro herramientas no aparecen en la lista.

Configúralo en tu cliente

Sigue los mismos pasos que la guía de instalación, pero añade los parámetros a la URL.
Mantén las comillas: de lo contrario, tu shell interpretaría el ? y el & por su cuenta.
Si tu cliente te permite definir encabezados, pero no editar la URL, envía X-MCP-Toolsets: core,workflows y X-MCP-Readonly: true en su lugar. Un valor en la URL tiene prioridad sobre el encabezado en lo que respecta a los conjuntos de herramientas, y el modo de solo lectura se activa si cualquiera de los dos lo solicita.
El plugin de ChatGPT usa su propio catálogo fijo y reducido, disponible en https://mcp.didit.me/mcp/chatgpt. Los conjuntos de herramientas y el modo de solo lectura no se aplican a él. Consulta Conectar ChatGPT.

Instrucciones, prompts y búsqueda en la documentación

El servidor ayuda al modelo a empezar por el lugar correcto:
  • Instrucciones. Al conectarse, el servidor indica al modelo que empiece con didit_context_get, explica cómo se resuelven organization_id y application_id, le pide que desarrolle dentro de una aplicación sandbox e indica qué conjuntos de herramientas ha cargado esta conexión.
  • Prompts. Los clientes que admiten prompts de MCP muestran cinco puntos de partida: integrate_didit, review_queue, explain_session, build_workflow y verification_report. En Claude Code aparecen como comandos slash.
  • Búsqueda en la documentación. didit_docs_search busca en estas páginas de documentación y devuelve las secciones coincidentes con sus enlaces, de modo que las preguntas sobre el funcionamiento de Didit se responden con las páginas actuales.

Comprueba qué cargó una conexión

Pregúntale a tu cliente:
El modelo responde a partir de las instrucciones del servidor. Para comprobar que un servidor admite conjuntos de herramientas antes de depender de ellos, consulta su endpoint de estado:
La respuesta enumera toolsets y read_only en features.

Próximos pasos

Instalación

Conecta Claude, ChatGPT, Cursor, VS Code, Codex o cualquier cliente MCP.

Referencia de herramientas

Cada herramienta, su tipo y el permiso del rol que necesita.

Autenticación

Inicia sesión con Didit y consulta los ámbitos y los permisos del rol.

Indicaciones de ejemplo

Indicaciones que funcionan desde el primer día.
Última modificación el 12 de noviembre de 2026