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ñadetoolsets 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.
- Los toolsets son opcionales. Una URL sin
toolsetslista todo. - Al indicar toolsets, se enumeran exactamente esos.
?toolsets=caseslista las herramientas de casos, además dedidit_context_get, que se incluye en cada conexión. Añadecoresi 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ñaderead_only=true a la URL del servidor:
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.
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:
- El modelo llama a
didit_tool_searchconinvite a teammatey obtienedidit_org_invite_member, marcada como de escritura. - Llama a
didit_tool_call_write, pasandodidit_org_invite_membercomonamejunto con los argumentos propios de esa herramienta. - Tu cliente te pide que apruebes la llamada, como hace con cualquier herramienta que modifica datos.
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.- Claude Code
- Codex
- Cursor
- VS Code
- Claude web y Desktop
- Servidor local
? y el & por su cuenta.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 resuelvenorganization_idyapplication_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_workflowyverification_report. En Claude Code aparecen como comandos slash. - Búsqueda en la documentación.
didit_docs_searchbusca 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: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.