Conectar Claude por MCP

Sherlock tiene un servidor MCP (Model Context Protocol). Al conectarlo, Claude puede trabajar en Sherlock por vos: crear un agente desde una plantilla, cargarle documentos, probarlo, escribir casos de prueba, evaluarlo, publicarlo y compartir el link, todo desde una conversación.

https://app.sherlock.posselab.net/mcp

El transporte es Streamable HTTP.

Claude actúa con tu rol

Claude ve y hace exactamente lo que tu rol permite en cada workspace: si sos Editor, no puede publicar; si sos Observador, solo consultar. Todo lo que hace queda en la auditoría a tu nombre, y publicar sigue exigiendo que la versión apruebe la evaluación, igual que en la consola.

claude.ai y Claude Desktop

Se conectan con OAuth: autorizás una vez en Sherlock y Claude nunca ve tu contraseña.

1. En Claude, abrí Settings → Connectors y elegí «Add custom connector».
2. Pegá la dirección https://app.sherlock.posselab.net/mcp y confirmá.
3. Claude abre Sherlock para que autorices la conexión. Si no tenés la sesión iniciada, ingresá con tu cuenta.
4. En «Claude quiere acceder a Sherlock en tu nombre» ves qué va a poder hacer según tu rol y en qué workspaces va a actuar. Hacé clic en «Permitir».
5. Listo: Sherlock aparece en tus conectores. En una conversación, activalo desde el menú de herramientas.

El pedido de autorización dura 10 minutos y se usa una sola vez; si vence, volvé a conectar desde Claude. En las organizaciones de claude.ai, puede que un administrador de la organización tenga que habilitar los conectores personalizados antes.

Claude Code

Claude Code se conecta con un token personal que manda en cada pedido. Sirve también para cualquier cliente MCP que acepte encabezados.

1. En Sherlock, abrí el menú de tu nombre (abajo a la izquierda) → «Conectar con Claude».
2. En la sección «Claude Code», hacé clic en «Crear token» y completá:
   • Nombre: para reconocerlo, por ejemplo «Claude Code en mi notebook».
   • Uso: «Solo Claude» (únicamente el servidor MCP, la opción más acotada) o «Claude y API».
   • Vencimiento: en 30 o 90 días, en un año o «No vence».
3. Copiá el token (empieza con shk_): se muestra completo una sola vez. El diálogo trae el comando listo para pegar:

claude mcp add --transport http sherlock https://app.sherlock.posselab.net/mcp \
  --header "Authorization: Bearer shk_..."

4. En Claude Code, escribí /mcp para comprobar que «sherlock» figura conectado.

Tratá el token como una contraseña

El token actúa con tu rol en todos tus workspaces, como si fueras vos. No lo pegues en repositorios ni lo compartas. Si se expuso, revocalo en «Conectar con Claude» y creá otro.

Qué puede hacer Claude

Herramienta	Qué hace
listar_workspaces	Lista tus workspaces, con tu rol en cada uno. Es el punto de partida.
listar_plantillas	Lista las plantillas de agentes (atención al cliente, seguros, RR. HH.…).
listar_agentes	Lista los agentes de un workspace con su estado, la última evaluación y la actividad de 7 días.
ver_agente	Muestra el borrador (instrucciones, reglas, tono, modelo, bases, derivación, guardrails), la versión en producción, la última evaluación y los canales.
crear_agente	Crea un agente como borrador, desde una plantilla o a partir de una descripción.
actualizar_agente	Modifica el borrador; producción no cambia hasta publicar. Un Editor o Publicador solo puede cambiar contenido.
listar_bases_conocimiento	Lista las bases con sus documentos, fragmentos y qué agentes las usan.
crear_base_conocimiento	Crea una base vacía, con embeddings locales.
agregar_documento_texto	Agrega un documento de texto o Markdown a una base y espera a que se indexe.
agregar_documento_url	Conecta una página o un sitio web como fuente de la base; se sincroniza cada hora. Requiere rol Constructor.
probar_busqueda	Devuelve los fragmentos que el agente usaría para responder una pregunta.
probar_agente	Conversa con el borrador y devuelve la respuesta con una traza compacta: pasos, fuentes, incidentes, latencia y costo.
crear_casos_de_prueba	Agrega casos de prueba: escritos por Claude, generados desde la documentación o los de red-teaming.
evaluar_agente	Corre los casos habilitados contra el borrador y devuelve la tasa, el umbral y los casos que fallaron.
ver_evaluacion	Muestra el resultado de una evaluación.
publicar_agente	Crea una versión, la evalúa y, solo si aprueba, la lleva a producción. Requiere rol Publicador o Constructor; Claude te confirma antes de usarla.
compartir_agente	Devuelve un link de chat público para el agente (lo crea si no existe y tu rol lo permite).
ver_metricas	Resume el uso en producción: conversaciones, costo, latencia, errores, incidentes, derivaciones y satisfacción.
ver_pendientes	Muestra la Bandeja del workspace según tu rol.
buscar_documentacion	Busca en esta documentación y devuelve las secciones relevantes con su enlace.

También ofrece el prompt crear-agente, que guía a Claude paso a paso para crear un agente de punta a punta. En claude.ai aparece en el menú de prompts del conector; en Claude Code, como /mcp__sherlock__crear-agente.

Prompts para probar

Copiá y pegá cualquiera de estos en Claude con el conector activo (la página «Conectar con Claude» trae otros, con botón para copiar):

1. Creá en el workspace Demo un asistente de seguros para asegurados de auto, a partir de la plantilla de seguros. Agregale a su base un documento con estos horarios de atención: lunes a viernes de 9 a 18, sábados de 9 a 13. Probalo con tres preguntas y contame cómo respondió.

2. Escribí 5 casos de prueba para el agente «Asistente de seguros (demo)» con preguntas reales sobre denuncia de siniestros y franquicias, evalualo y explicame qué casos fallaron y por qué.

3. Mostrame las métricas de los últimos 30 días del workspace Demo: conversaciones, costo, satisfacción e incidentes. Resumilo en tres oraciones para enviarle al cliente.

4. ¿Qué tengo pendiente en la Bandeja de mis workspaces? Ordenalo por urgencia y decime qué tendría que hacer primero.

5. Cambiá el tono del agente «Asistente de pólizas de auto» a cercano, agregale la regla «cuando pregunten por precios, ofrecé que un asesor los contacte», evalualo y, si aprueba, publicalo y pasame el link para compartir.

Consejo

Pedile a Claude que te muestre el resultado de la evaluación antes de publicar. Si no aprueba, la versión queda «No aprobada» y producción no cambia, igual que en la consola.

Seguridad

• Autorización con OAuth en claude.ai y Claude Desktop: Sherlock nunca le da tu contraseña a Claude.
• Tu rol, tus workspaces: Claude no ve workspaces a los que no tenés acceso.
• Auditoría: cada acción queda registrada con tu nombre, como si la hubieras hecho en la consola.
• Evaluación obligatoria: Claude no puede saltear la evaluación para publicar.
• Datos personales: las respuestas de prueba pasan por los mismos guardrails que cualquier canal.

Para desconectar Claude, en «Conectar con Claude»:

• Conexiones activas lista los conectores que autorizaste desde claude.ai o Claude Desktop, con su último uso. «Desconectar» revoca sus permisos: deja de poder actuar en tu nombre hasta que lo vuelvas a autorizar.
• La tabla de tokens personales muestra el uso, la creación, el último uso y el vencimiento de cada uno. «Revocar» lo invalida de inmediato.

En Claude Code, además, podés quitar el servidor con claude mcp remove sherlock.