Vythos MCP

npx add-mcp 'https://api.vythos.tech/api/mcp/sse'

Todo lo que necesitas está en la página de herramientas de IA en Vythos: la dirección del servidor, una clave y un fragmento de código listo para cada herramienta. Copia desde allí en lugar de desde aquí: la dirección se te muestra en lugar de estar codificada, por lo que siempre es la correcta para tu espacio de trabajo.

Dos formas de demostrar quién eres

Claude Desktop inicia sesión con tu cuenta de Vythos (OAuth): no hay clave que pegar o mantener segura. Todo lo demás usa una clave enviada como encabezado Authorization: Bearer …. En cualquier caso, la conexión lleva el acceso de la persona a la que pertenece.

Claude Desktop

1. En Vythos, abre herramientas de IA y copia la dirección del servidor.
2. En Claude Desktop: Configuración → Conectores → Agregar → Conector personalizado.
3. Pega la dirección y elige Conectar.
4. Tu navegador se abre. Inicia sesión en Vythos y aprueba. La conexión puede leer tu Playbook, buscar en tu memoria y registrar resultados, exactamente como lo indica la página de aprobación; no puede cambiar una regla.

No se necesita clave. La conexión aparece en la página de herramientas de IA, donde puedes ver cuándo se usó por última vez.

Claude Code

1. En Vythos, herramientas de IA → Nueva clave, dale una etiqueta como Claude Code y copia tanto la clave como la dirección.
2. Ejecuta el comando que se muestra en la página:

claude mcp add --transport http vythos <server-address> \
  --header "Authorization: Bearer <your-key>"

Usa --transport http. La dirección termina en /sse por razones históricas, pero el servidor habla Streamable HTTP: --transport sse no logra conectarse.

Cursor

Crea o edita .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "vythos": {
      "url": "<server-address>",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

Windsurf

Configuración → MCP, o edita ~/.codeium/windsurf/mcp_config.json con la misma forma que la configuración de Cursor anterior.

Cualquier otro cliente MCP

Tres valores, y todo cliente MCP los necesita:

URL del servidor	Desde la página de herramientas de IA
Transporte	Streamable HTTP (POST)
Encabezado de autenticación	Authorization: Bearer <your-key>

La mayoría de las herramientas que anuncian soporte MCP funcionan con esto. Las que se enumeran en la página de herramientas de IA son las que hemos conectado nosotros mismos.

Verifica que funcionó

Pide a tu herramienta que haga algo que necesite tus reglas:

"Usando Vythos, ¿cuáles son nuestros términos de pago estándar?"

o, mejor, una tarea real:

"Redacta una propuesta de proyecto para Acme por un retenedor de tres meses. Obtén las reglas de Vythos primero y revisa el borrador antes de mostrármelo."

Deberías ver que la herramienta llama a Vythos, cita cifras que coinciden con tu Playbook y, en la verificación, o informa que no encontró nada o nombra la regla que una línea rompe.

Si no se conecta

Síntoma	Causa probable
El cliente no puede alcanzar el servidor	Verifica que la dirección sea exactamente la de la página de herramientas de IA, incluido /sse
Se conecta, pero cada llamada es rechazada	La clave es incorrecta, está revocada o le falta el prefijo Bearer
Claude Code se conecta y luego se cae	Usaste --transport sse. Usa --transport http
Se conecta pero no devuelve nada útil	Verifica el acceso de quien posee la clave. Una categoría configurada sin acceso nunca se envía
La dirección sigue cambiando	Tu espacio de trabajo apunta a una dirección de desarrollo temporal. La página de herramientas de IA indica cuándo es el caso: pídenos la permanente

Claves e higiene

Una clave se muestra una vez, cuando la creas. Guárdala donde guardas otros secretos, una clave por herramienta, y revoca cualquier clave de la que no estés seguro: la revocación tiene efecto inmediato. Consulta Claves.