Conectar tu propio asistente

Tu asistente (Claude Desktop, Claude Code, Cursor, Visual Studio Code o cualquier cliente que hable MCP con un token bearer) puede leer y cambiar tu trabajo como tú, con tus permisos. Necesita dos cosas: que los tokens estén permitidos en el espacio de trabajo, y un token tuyo. Configurarlo lleva tres pasos: obtener un token, darle a tu cliente la dirección y el token, preguntarle algo.

Antes de empezar

Un administrador activa los tokens en Configuración → Tokens de acceso, y puede limitar su duración o hacer que todos sean de solo lectura. Hasta entonces, Mi perfil → Tokens de acceso indica que los tokens están desactivados.
Crea un token en Mi perfil → Tokens de acceso (ver Tokens de acceso). Dale el nombre del cliente que lo va a guardar. Copia el secreto cuando se muestre: se muestra una sola vez. Un token de solo lectura es el indicado para empezar.
Cada persona se conecta con su propio token. Un token nunca se comparte: lo que hace el asistente queda registrado a nombre de la persona dueña del token.

Paso 1: La dirección y el encabezado

El servidor es la dirección en la que inicias sesión, seguida de /mcp (ver La dirección de tu espacio de trabajo). Para un espacio de trabajo en https://acme.mbovy.com, es:

https://acme.mbovy.com/mcp

El token viaja en un encabezado de cada solicitud: la palabra Bearer, un espacio y el secreto tal como lo copiaste:

Authorization: Bearer pat_...

Paso 2: Agrega el servidor a tu cliente

Claude Code

En una terminal, una sola vez, con tu propia dirección y tu secreto:

claude mcp add --transport http -s user mbovy https://acme.mbovy.com/mcp --header "Authorization: Bearer pat_..."

claude mcp list muestra entonces mbovy como conectado, y /mcp dentro de una sesión lista sus herramientas. -s user lo registra para ti en todas las carpetas; sin eso, el servidor queda registrado solo para la carpeta en la que estás.

Claude Desktop y claude.ai

Abre Settings → Connectors y elige Add custom connector.
Name: mbovy. URL: tu dirección con /mcp.
Authentication: No sign in.
En Request headers, agrega un encabezado: nombre Authorization, valor Bearer pat_....
Agrégalo y luego activa el conector en un chat desde el menú de herramientas.

Claude llega a tu espacio de trabajo desde sus propios servidores, así que el espacio de trabajo tiene que ser accesible desde internet; uno alojado lo es.

Cursor

Abre Cursor Settings → Tools & MCP → New MCP server, que abre mcp.json, y agrega:

{
  "mcpServers": {
    "mbovy": {
      "url": "https://acme.mbovy.com/mcp",
      "headers": { "Authorization": "Bearer pat_..." }
    }
  }
}

Visual Studio Code

En el .vscode/mcp.json de un espacio de trabajo, o en tu mcp.json de usuario:

{
  "servers": {
    "mbovy": {
      "type": "http",
      "url": "https://acme.mbovy.com/mcp",
      "headers": { "Authorization": "Bearer pat_..." }
    }
  }
}

Otros clientes

Cualquier cliente que acepte un servidor de tipo streamable HTTP con una dirección y un encabezado funciona de la misma manera. Un cliente que solo puede iniciar sesión por una página web todavía no puede conectarse.

Paso 3: Pruébalo

Pregunta, con tus propias palabras:

¿Quién soy en mbovy? El asistente responde con tu nombre, tu espacio de trabajo y si el token es de solo lectura. Si esto funciona, todo lo demás funcionará.
¿Qué tengo vencido?
Cuenta las tareas abiertas por persona.
Muéstrame la tarea 112 con sus comentarios.
Carga 30 minutos en la tarea 112 para hoy.

Nunca nombras una herramienta: el asistente elige una de la lista de abajo. Cada respuesta trae un enlace al elemento, para que lo abras en la aplicación y compruebes lo que hizo el asistente.

Qué puede hacer el asistente

Herramienta	Qué hace
`whoami`	Quién eres, tu espacio de trabajo, tus roles y permisos, y si el token es de solo lectura
`find_work_items`	Elementos de trabajo que puedes ver, filtrados por cliente, proyecto, persona, estado, prioridad, tipo, fechas o palabras; como máximo 50, con el total
`get_work_item`	Un elemento con su estimación y su tiempo dedicado, sus subelementos y sus últimos comentarios
`work_counts`	Elementos contados por persona, cliente, proyecto, estado o prioridad; requiere el permiso de ejecutar reportes
`my_week`	Tu propio tiempo registrado en una semana, por elemento y día
`run_report`	Un reporte guardado por nombre, con un período relativo o un rango de fechas; requiere el permiso de ejecutar reportes
`list_customers`	Clientes, por nombre
`create_task`	Una tarea, fase o subtarea dentro de un proyecto, fase o tarea que puedes editar
`set_status`	Mueve un elemento a Draft, Open, InProgress, OnHold o Done
`add_time`	Suma minutos de tu tiempo a un elemento en un día
`add_comment`	Un comentario en un elemento, escrito como tú

Ninguna herramienta elimina nada, ninguna crea proyectos, y cada escritura cambia un solo elemento. Los permisos y la visibilidad son los tuyos: un elemento que no puedes abrir, el asistente tampoco puede leerlo. Con un token de solo lectura, las herramientas que escriben responden que no se ejecutaron. Cada herramienta de lectura devuelve como máximo 50 filas y dice el total, y cada token puede hacer una cantidad limitada de llamadas por minuto; pasada esa cantidad, el asistente recibe la indicación de esperar.

Cuando deja de funcionar

El asistente dice	Qué pasó	Qué hacer
El servidor rechazó la conexión, o unauthorized	El token venció, fue revocado, o los tokens están desactivados en el espacio de trabajo. Un cambio de contraseña, o cerrar sesión en todas partes, también termina todos los tokens.	Crea un token nuevo en Mi perfil → Tokens de acceso y actualiza el cliente. Si los tokens están desactivados, pide a un administrador que los active.
La herramienta no se ejecutó porque el token es de solo lectura	El token, o todo el espacio de trabajo, es de solo lectura.	Crea un token sin solo lectura, si el espacio de trabajo lo permite.
La herramienta requiere un permiso que no tienes	El mismo permiso que pediría la pantalla, por ejemplo ejecutar reportes.	Pide el permiso a un administrador; el asistente tiene exactamente los tuyos.
Demasiadas llamadas	Más llamadas en un minuto de las que un token puede hacer.	Espera un minuto.

Cada uso rechazado queda en tu Registro de seguridad, con el motivo.