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.

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 se genera automáticamente a partir de la API de Tess — cada endpoint se convierte en una herramienta MCP, así que las nuevas capacidades de la API aparecen sin ningún cambio en el servidor. 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` · `list_agent_responses` · `get_agent_response` · `list_agent_webhooks` · `create_agent_webhook` · `agent_chat_completions`
Archivos	`list_files` · `upload_file` · `get_file` · `delete_file` · `process_file` · `resolve_durable_file_reference`
Memorias	`list_memories` · `create_memory` · `update_memory` · `delete_memory` · `import_memories_text` · `get_memory_import_status_result`
Webhooks	`list_webhooks` · `delete_webhook`
Créditos y workspace	`deduct_credits_user` · `get_workspace_usage`

Esta lista cubre todas las herramientas relevantes para una integración de terceros. También existen herramientas de organización de carpetas/chats (usadas internamente por la interfaz web de Tess), pero no se documentan aquí — pídele a tu asistente que “liste las herramientas disponibles” para ver el conjunto completo y actual directamente desde tu cliente MCP.

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.”

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"
      }
    }
  }
}

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.

string

Busca agentes por título, descripción y descripción larga.

string

Filtra por tipo de agente.

integer

predeterminado:"1"

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

integer

predeterminado:"15"

Cantidad de agentes por página.

get_agent

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

string | integer

requerido

El ID del agente.

execute_agent

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

string | integer

requerido

El ID del agente.

object

requerido

Las respuestas del agente. Para agentes de tipo chat, incluye un array messages (pares role/content, con el mismo formato que OpenAI Chat Completions).

boolean

predeterminado:"false"

Cuando es true, espera a que termine la ejecución y devuelve la salida final. Cuando es false, devuelve de inmediato para que consultes la ejecución después.

list_files_agent

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

integer

requerido

ID del agente para el cual recuperar los archivos.

link_files_agent

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

integer

requerido

ID del agente al que vincular los archivos.

integer[]

requerido

Array de IDs de archivos a vincular al agente.

delete_file_link_agent

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

integer

requerido

ID del agente del que eliminar el vínculo del archivo.

integer

requerido

ID del archivo a desvincular del agente.

list_agent_responses

Lista respuestas de ejecuciones de agentes, con filtros y paginación.

string

Busca agentes por título.

integer

Filtra por el ID de ejecución raíz.

integer

Filtra por el ID del agente.

string

Filtra por tipo de agente.

string

predeterminado:"asc"

Ordena de forma ascendente o descendente (asc/desc).

integer

predeterminado:"1"

Página actual.

integer

predeterminado:"15"

Cantidad de elementos por página.

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).

agent_chat_completions

Ejecuta un agente a través de una interfaz compatible con OpenAI Chat Completions — útil para clientes ya integrados con el formato de la API de OpenAI.

string | integer

requerido

El ID del agente.

object

requerido

Un cuerpo de solicitud con el formato de OpenAI Chat Completions.

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.

resolve_durable_file_reference

Resuelve una referencia de artefacto durable doc://<universal_id> (devuelta como ref_url) en una URL de descarga firmada, recién generada y de corta duración. La identidad y el alcance del workspace provienen de tu token de API.

string

requerido

La referencia de artefacto durable a resolver.

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.

import_memories_text

Activa una importación masiva de memorias desde texto libre. Asíncrono por defecto.

boolean

predeterminado:"false"

Si debe bloquear hasta que la importación se complete (con tiempo límite acotado) en lugar de devolver de inmediato.

get_memory_import_status_result

Devuelve el estado y el resumen de una ejecución de importación de memorias.

string | integer

requerido

El ID de la ejecución de importación.

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.

deduct_credits_user

Deduce créditos de un usuario específico según el factor base del sistema de créditos y los parámetros de cálculo. Pensado para integraciones a nivel de plataforma que miden el uso de un recurso personalizado.

integer

requerido

Identificador del usuario/workspace del que se deducirán los créditos.

string

requerido

Tipo de recurso que se está midiendo (por ejemplo, image).

number

requerido

Valor numérico positivo usado en el cálculo de créditos.

integer

El ID del workspace.

string

ID del recurso que se está midiendo.

object

Entradas adicionales para el cálculo de créditos.

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.

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).

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.

​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

​list_agent_responses

​get_agent_response

​list_agent_webhooks

​create_agent_webhook

​agent_chat_completions

​list_files

​upload_file

​get_file

​delete_file

​process_file

​resolve_durable_file_reference

​list_memories

​create_memory

​update_memory

​delete_memory

​import_memories_text

​get_memory_import_status_result

​list_webhooks

​delete_webhook

​deduct_credits_user

​get_workspace_usage

​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

list_agent_responses

get_agent_response

list_agent_webhooks

create_agent_webhook

agent_chat_completions

list_files

upload_file

get_file

delete_file

process_file

resolve_durable_file_reference

list_memories

create_memory

update_memory

delete_memory

import_memories_text

get_memory_import_status_result

list_webhooks

delete_webhook

deduct_credits_user

get_workspace_usage

Ejemplo: ejecuta un agente de principio a fin

Gobernanza y cumplimiento

Solución de problemas

Recursos