Varios clientes, un solo servidor MCP: el llavero de cuentas

Una agencia no tiene un cliente: tiene diez, y cada uno tiene su propia cuenta de CognitionDesk.

Con una sola key, atender a dos clientes desde el mismo agente obliga a levantar el servidor MCP dos veces, con dos .env. Son dos copias de las mismas tools en cada sesión, las dos contestan bien y ninguna te dice en qué cuenta estás. Leer la respuesta correcta en la cuenta equivocada no da error: simplemente parece la respuesta correcta.

Desde la 0.9.0 (la primera versión en npm que lo trae), @cognitiondesk/mcp tiene un llavero: una sola instancia con varias cuentas.

1. Las cuentas, con alias

claude mcp add cognitiondesk \
  -e 'COGNITIONDESK_ACCOUNTS={"cliente-a":"<key de A>","cliente-b":"<key de B>"}' \
  -- npx -y @cognitiondesk/mcp

Es un JSON {"alias": "<key>"}. La primera es la activa al arrancar (o la que diga COGNITIONDESK_ACTIVE_ACCOUNT). Si una cuenta vive en otro backend, va como objeto: {"key": "…", "url": "https://…"}. COGNITIONDESK_API_KEY sola sigue funcionando como antes: es un llavero con una sola cuenta, llamada default.

Ninguna tool devuelve el valor de una key. Lo único que sale del llavero son los alias.

2. Cambiar de cuenta es una tool

Esta es la salida real de la 0.10.0 con dos keys de prueba:

> use_account {"name":"cliente-b"}
account: cliente-b

Active account is now 'cliente-b'. Available: cliente-a, cliente-b.

get_connection_status lista las cuentas del llavero y cuál está activa. Las tools de lectura aceptan además un argumento account para mirar otra cuenta sin cambiar de cuenta, por ejemplo para comparar el asistente de A con el de B.

3. Cada respuesta dice de qué cuenta viene

Todas las respuestas, también los errores, empiezan con account: <alias>. Esa línea no es decoración: si tu agente está por editar un asistente y la línea dice cliente-a cuando creías estar en B, lo ves antes de escribir.

La regla que conviene darle al agente es corta: las escrituras siempre van a la cuenta activa. Primero use_account y después editar, mirando la línea que vuelve.

Lo que el llavero no hace

En el MCP remoto (mcp.cognitiondesk.com/mcp) el llavero no se usa. Ahí cada request trae su propia key en x-api-key, y el servidor no recurre a ninguna key de su entorno. Si lo hiciera, un cliente del remoto terminaría trabajando con la cuenta de otro. El llavero es para el MCP que corre en tu máquina con npx.

Está en la guía del MCP. Si manejás más cuentas de las que entran cómodas en un llavero, escribinos.