Servidor MCP - Tess AI Docs

El Servidor MCP de Tess AI convierte tus agentes, ejecuciones y memorias de Tess en herramientas que cualquier cliente del Model Context Protocol (MCP) puede invocar. Es un endpoint alojado y gestionado: no hay nada que instalar, empaquetar ni ejecutar. Apunta tu plataforma de IA a una única URL, autentícate con tu token de API de Tess y tu equipo podrá listar, ejecutar y orquestar agentes de Tess directamente desde las herramientas que ya usa.

Endpoint: https://mcp.tess.im — un servidor MCP remoto que usa el transporte Streamable HTTP. Sin npx, sin proceso local, sin necesidad de Node.js.

Servidor MCP de Tess

Esta página. Expón agentes, archivos y memorias de Tess a Claude, Cursor, Codex o cualquier cliente MCP.

Custom MCP

El otro sentido: conecta servidores MCP externos al chat y a los agentes de Tess, con alcance personal o compartido.

Por qué conectar mediante MCP

Usa Tess donde tu equipo ya trabaja

Ejecuta agentes de Tess dentro de Claude, Cursor, Codex o tus propias herramientas internas — sin cambiar de contexto, sin copiar y pegar.

Cero instalación, siempre actualizado

Un endpoint gestionado por Tess. Las nuevas capacidades aparecen automáticamente; no hay cliente que actualizar.

Gobernado por tu workspace

Cada llamada se ejecuta con el token y el workspace de quien la realiza, heredando tus roles, permisos y límites de créditos existentes.

Estándar y portátil

Construido sobre el protocolo abierto MCP. El mismo endpoint funciona en todas las plataformas compatibles — sin integración por proveedor.

Qué expone el servidor

El conjunto de herramientas es una lista explícita de la API pública de Tess — los mismos endpoints documentados en Descripción general de la API. Las nuevas capacidades de la API solo aparecen como herramientas MCP después de entrar en esa superficie pública. Todas las herramientas están listadas abajo, agrupadas por dominio, cada una con su propia entrada enlazable en Referencia de herramientas.

Dominio	Herramientas
Agentes	`list_agents` · `get_agent` · `execute_agent` · `list_files_agent` · `link_files_agent` · `delete_file_link_agent` · `get_agent_response` · `list_agent_webhooks` · `create_agent_webhook`
Archivos	`list_files` · `upload_file` · `get_file` · `delete_file` · `process_file`
Memorias	`list_memories` · `create_memory` · `update_memory` · `delete_memory`
Colecciones de memoria	`list_memory_collections` · `create_memory_collection` · `update_memory_collection` · `delete_memory_collection`
Webhooks	`list_webhooks` · `delete_webhook`
Workspace y auditoría	`get_workspace_usage` · `list_audit_events`

La lista coincide con la API pública. Los endpoints internos solo de sesión nunca se exponen como herramientas MCP. Pídele a tu asistente que liste las herramientas disponibles si quieres confirmar el conjunto en vivo desde tu cliente.

Antes de empezar

Necesitas dos datos de la plataforma Tess:

Tu token de API

Genera un token de acceso personal en Tess AI → Tokens de API. Es el mismo token usado en toda la API de Tess — consulta el Quickstart para más detalles.

El ID de tu workspace

El servidor MCP está delimitado por workspace. Encuentra el ID de tu workspace en la URL del panel de Tess o en la configuración del workspace, y usa el del workspace cuyos agentes quieres alcanzar. Cada llamada queda aislada a ese workspace.

Trata tu token de API como una contraseña. Otorga acceso a los agentes y ejecuciones de tu workspace, que pueden consumir créditos. Prefiere un token dedicado por integración para poder revocarlo de forma independiente.

Autenticación

Las credenciales se envían solo como encabezados HTTP — nunca como parámetros de URL, para que los tokens no terminen en logs ni en el historial del navegador:

Authorization: Bearer TU_TOKEN_DE_API
x-workspace-id: TU_WORKSPACE_ID

Ambos encabezados son obligatorios en cada solicitud. Obligatorio a partir del 01/09/2026 para el alcance de workspace de la API Tess (misma política del header de la API REST). No hay alternativa mediante parámetros de URL — tu cliente MCP debe admitir el envío de encabezados personalizados.

Conecta tu plataforma

Claude Code
Cursor / VS Code
Codex CLI
Claude Desktop / ChatGPT / otros

claude mcp add tess --transport http https://mcp.tess.im \\
  --header "Authorization: Bearer TU_TOKEN_DE_API" \\
  --header "x-workspace-id: TU_WORKSPACE_ID"

Luego, en una sesión: “Usa Tess para ejecutar el agente de Code Review en este diff.”Las configuraciones JSON remotas necesitan type definido como http (o streamable-http). Una url sin type se ignora como servidor stdio roto.

Agrega Tess a tu configuración MCP (en Cursor: Tools & Integrations → MCP Tools, o ~/.cursor/mcp.json):

{
  "mcpServers": {
    "tess": {
      "url": "https://mcp.tess.im",
      "headers": {
        "Authorization": "Bearer TU_TOKEN_DE_API",
        "x-workspace-id": "TU_WORKSPACE_ID"
      }
    }
  }
}

Prefiere interpolar una variable de entorno para el token en lugar de guardarlo en texto plano. Cursor resuelve interpolación de env en url y headers.

Agrega un servidor MCP remoto con encabezados en ~/.codex/config.toml:

[mcp_servers.tess]
url = "https://mcp.tess.im"
headers = { Authorization = "Bearer TU_TOKEN_DE_API", "x-workspace-id" = "TU_WORKSPACE_ID" }

La sintaxis de configuración puede cambiar entre versiones de Codex CLI — consulta codex mcp --help o la documentación actual de Codex si esto no coincide con lo que ves.

Estas plataformas se conectan a servidores MCP remotos mediante una interfaz de “conector personalizado”. Para funcionar con Tess, la configuración del conector debe permitir definir dos cosas:

La URL del endpoint: https://mcp.tess.im
Dos encabezados personalizados: Authorization: Bearer TU_TOKEN_DE_API y x-workspace-id: TU_WORKSPACE_ID

Algunas interfaces de conector solo exponen un único campo de bearer token y no admiten agregar un segundo encabezado personalizado — consulta la documentación actual de tu plataforma para saber si admite encabezados personalizados (además de un bearer token) para conectores MCP remotos. Si tu plataforma solo admite un encabezado de autenticación, usa uno de los clientes con soporte de encabezados anteriores (Claude Code, Cursor, Codex CLI) o una integración personalizada.

Cómo funciona la autenticación

El servidor MCP es una puerta de enlace sin estado. No almacena tus credenciales. En cada solicitud:

Lee tu token de API y el ID del workspace desde los encabezados de la solicitud.
Reenvía la llamada a la API de Tess como tú, exactamente como lo haría una llamada directa a la API.
Devuelve el resultado a tu cliente MCP.

Esto significa que el servidor hereda todos los controles existentes de tu plataforma:

Identidad y permisos

Las llamadas se ejecutan con la identidad del propietario del token. La visibilidad de agentes, los roles y los permisos de funciones los aplica Tess, sin atajos.

Aislamiento de workspace

Cada solicitud se vincula al x-workspace-id enviado. Un token no puede alcanzar datos de otro workspace.

Gobernanza de créditos

Las ejecuciones consumen créditos según los límites y la facturación de tu workspace — igual que la API de Tess.

Acceso revocable

Revoca un token en el panel para cortar al instante cualquier plataforma conectada que lo use. Sin necesidad de redeploy.

Referencia de herramientas

list_agents

Lista los agentes disponibles en el workspace, con búsqueda y paginación.

get_agent

Devuelve los detalles completos de un agente (entradas, tipo, descripción).

execute_agent

Ejecuta un agente con las entradas indicadas y, opcionalmente, espera el resultado.

list_files_agent

Obtiene la lista de archivos asociados a un agente específico.

link_files_agent

Asocia uno o más archivos a un agente específico.

delete_file_link_agent

Elimina la asociación entre un archivo específico y un agente.

get_agent_response

Obtiene una respuesta de ejecución de agente específica por ID.

string | integer

requerido

El ID de la ejecución del agente.

list_agent_webhooks

Lista los webhooks registrados para un agente específico.

integer

requerido

ID del agente.

integer

predeterminado:"1"

Página actual.

integer

predeterminado:"15"

Cantidad de elementos por página.

create_agent_webhook

Registra un nuevo webhook en un agente específico.

string | integer

requerido

El ID del agente.

string

La URL de destino del webhook.

string

predeterminado:"POST"

Método HTTP usado en la llamada del webhook.

string

predeterminado:"active"

Estado del webhook (active/inactivo).

list_files

Obtiene una lista paginada de archivos del workspace, con opciones de ordenación.

integer

predeterminado:"1"

Número de página para la paginación.

integer

predeterminado:"15"

Cantidad de elementos por página (máx. 100).

string

predeterminado:"desc"

Orden de clasificación por el campo created_at (asc/desc).

upload_file

Sube un nuevo archivo al workspace y opcionalmente lo procesa.

binary

requerido

El archivo a subir.

boolean

predeterminado:"false"

Si el archivo debe procesarse inmediatamente después de subirlo.

get_file

Devuelve los detalles de un archivo específico.

integer

requerido

El ID del archivo.

delete_file

Elimina un archivo del workspace.

integer

requerido

El ID del archivo.

process_file

Activa (o reactiva) el procesamiento de un archivo ya subido.

integer

requerido

El ID del archivo.

list_memories

Lista las memorias almacenadas en el workspace.

integer

Filtra por colección de memorias.

integer

predeterminado:"1"

Número de página para la paginación.

integer

predeterminado:"10"

Elementos por página (máx. 50).

create_memory

Guarda una nueva memoria en una colección.

integer

La colección de memorias donde almacenarla.

string

El texto de la memoria a almacenar (máx. 32.000 caracteres).

update_memory

Edita una memoria existente.

integer

requerido

La memoria a actualizar.

string

Nuevo texto de la memoria.

integer

Mueve la memoria a otra colección.

delete_memory

Elimina una memoria existente.

integer

requerido

La memoria a eliminar.

list_memory_collections

Lista las colecciones de memoria del workspace.

string

Filtra colecciones por nombre.

integer

predeterminado:"1"

Número de página.

integer

predeterminado:"12"

Elementos por página (1–50).

create_memory_collection

Crea una colección de memoria.

string

requerido

Nombre de la colección.

string

Descripción opcional.

update_memory_collection

Actualiza una colección de memoria.

integer

requerido

La colección a actualizar.

string

Nuevo nombre.

string

Nueva descripción.

delete_memory_collection

Elimina una colección de memoria.

integer

requerido

La colección a eliminar.

list_webhooks

Lista todos los webhooks del workspace.

integer

predeterminado:"1"

Página actual.

integer

predeterminado:"15"

Cantidad de elementos por página.

delete_webhook

Elimina un webhook por ID.

integer

requerido

El ID del webhook.

get_workspace_usage

Devuelve el uso del workspace desglosado por tipo y rango de fechas.

string

Filtro de rango de fechas predefinido (1d/7d/30d).

string

Fecha de inicio personalizada (YYYY-MM-DD). Úsala con end_date; sobrescribe range.

string

Fecha de fin personalizada (YYYY-MM-DD). Úsala con start_date; sobrescribe range.

integer

Filtra por ID de usuario (requiere el permiso WORKSPACE_DOCUMENTS_READ).

string

Filtra por tipo de uso (chat, image, text, tool_execution, connector_calls, entre otros).

integer

predeterminado:"1"

Número de página para la paginación.

list_audit_events

Obtiene eventos de auditoría del workspace para ingestión en SIEM. La ventana de tiempo es obligatoria y no puede superar 30 días.

string

requerido

Inicio de la ventana (YYYY-MM-DD).

string

requerido

Fin de la ventana (YYYY-MM-DD). Debe estar a no más de 30 días de from.

integer

predeterminado:"50"

Máximo de eventos por página (1–200).

string

Cursor opaco de paginación de la respuesta anterior.

string

Filtra por origen (auditable o activity).

string

Filtra por tipo de evento.

integer

Filtra por actor.

Ejemplo: ejecuta un agente de principio a fin

Una vez conectado, puedes conducir un flujo completo en lenguaje natural:

Descubre los agentes

“Lista mis agentes de Tess” → el asistente invoca list_agents y muestra lo disponible.

Captura contexto como memoria

“Guarda en mi colección ‘Estándares de Ingeniería’: escribe siempre pruebas unitarias con BDD” → create_memory.

Ejecuta un agente

“Usa el agente de Code Review para revisar esta función, y espera el resultado” → execute_agent devuelve la salida al instante.

Reutiliza más tarde

“Lista mis memorias” → list_memories confirma lo almacenado para futuras ejecuciones.

Gobernanza y cumplimiento

Privilegio mínimo — conéctate con un token delimitado a un único workspace y solo con los permisos que esa integración necesita.
Auditabilidad — las ejecuciones disparadas vía MCP aparecen en el historial y el uso de tu workspace en Tess, como cualquier llamada a la API.
Sin almacenamiento de credenciales — la puerta de enlace no tiene estado; los tokens viven solo en la configuración de tu cliente MCP.
Revocación centralizada — desactivar un token en el panel bloquea de inmediato todas las plataformas que lo usan.

Solución de problemas

El cliente conecta pero no aparece ninguna herramienta

Confirma que tu cliente usa el transporte Streamable HTTP (remoto) en lugar de un comando local/stdio, y que apunta directamente a https://mcp.tess.im (sin ruta adicional). En Claude Code, las entradas JSON remotas también necesitan type definido como http.

Errores 401 / 'no autorizado'

Ambos encabezados son obligatorios en cada solicitud — Authorization: Bearer TU_TOKEN_DE_API y x-workspace-id: TU_WORKSPACE_ID. No hay opción mediante parámetros de URL; confirma que tu cliente admite el envío de encabezados personalizados y que el token está activo en el panel.

Errores 404 o de 'workspace'

Falta el ID del workspace, está mal formado, o el token no tiene acceso a él. Confirma que el encabezado x-workspace-id esté definido y corresponda a un workspace accesible por tu token.

Un agente falla al ejecutarse

Algunos agentes requieren entradas específicas. Los agentes de tipo chat, por ejemplo, esperan un array messages dentro de body. Pide al asistente que inspeccione los campos del agente (get_agent), o revisa el agente en la plataforma Tess.

Recursos

Custom MCP — conecta servidores MCP externos a Tess
Compartir y permisos
Buenas prácticas de MCP
Model Context Protocol — sitio oficial
Cómo crear un Token de API en Tess AI

Servidor MCP de Tess

Custom MCP

​Por qué conectar mediante MCP

Usa Tess donde tu equipo ya trabaja

Cero instalación, siempre actualizado

Gobernado por tu workspace

Estándar y portátil

​Qué expone el servidor

​Antes de empezar

​Autenticación

​Conecta tu plataforma

​Cómo funciona la autenticación

Identidad y permisos

Aislamiento de workspace

Gobernanza de créditos

Acceso revocable

​Referencia de herramientas

​list_agents

​get_agent

​execute_agent

​list_files_agent

​link_files_agent

​delete_file_link_agent

​get_agent_response

​list_agent_webhooks

​create_agent_webhook

​list_files

​upload_file

​get_file

​delete_file

​process_file

​list_memories

​create_memory

​update_memory

​delete_memory

​list_memory_collections

​create_memory_collection

​update_memory_collection

​delete_memory_collection

​list_webhooks

​delete_webhook

​get_workspace_usage

​list_audit_events

​Ejemplo: ejecuta un agente de principio a fin

​Gobernanza y cumplimiento

​Solución de problemas

​Recursos

Por qué conectar mediante MCP

Qué expone el servidor

Antes de empezar

Autenticación

Conecta tu plataforma

Cómo funciona la autenticación

Referencia de herramientas

list_agents

get_agent

execute_agent

list_files_agent

link_files_agent

delete_file_link_agent

get_agent_response

list_agent_webhooks

create_agent_webhook

list_files

upload_file

get_file

delete_file

process_file

list_memories

create_memory

update_memory

delete_memory

list_memory_collections

create_memory_collection

update_memory_collection

delete_memory_collection

list_webhooks

delete_webhook

get_workspace_usage

list_audit_events

Ejemplo: ejecuta un agente de principio a fin

Gobernanza y cumplimiento

Solución de problemas

Recursos