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`
Mission Control	`get_mission_control_usage`
Versiones de agente	`list_agent_versions` · `get_agent_version` · `rollback_agent_version`
Programaciones de agentes	`list_all_schedulers` · `list_agent_schedulers` · `create_agent_scheduler` · `get_agent_scheduler` · `update_agent_scheduler` · `delete_agent_scheduler` · `delete_scheduler_by_root_execution`
Artifacts (Public Pages)	`list_artifacts` · `create_artifact` · `read_artifact` · `rename_artifact` · `delete_artifact` · `edit_artifact` · `publish_artifact_version` · `unpublish_artifact` · `restore_artifact_version` · `share_or_unshare_artifact` · `list_artifact_versions` · `delete_one_artifact_version` · `list_artifact_templates`
Importación de recuerdos	`import_memories_text` · `get_memory_import_status_result`
Digital Employees	`list_digital_employee_capabilities` · `list_digital_employees` · `create_standalone_digital_employee` · `create_digital_employee_agent` · `get_digital_employee` · `update_digital_employee` · `duplicate_digital_employee` · `delete_digital_employee` · `preview_digital_employee_schedule` · `invoke_digital_employee` · `retry_digital_employee_run` · `list_digital_employee_runs` · `get_digital_employee_run` · `get_digital_employee_run_output` · `pause_digital_employee` · `resume_digital_employee` · `list_digital_employee_rollback_options` · `rollback_digital_employee` · `reparent_digital_employee` · `detach_digital_employee` · `get_digital_employee_run_summary` · `get_digital_employee_activity` · `list_digital_employee_files` · `update_digital_employee_goal` · `approve_digital_employee` · `reject_digital_employee` · `upload_digital_employee_avatar` · `export_digital_employee_template_pack` · `preview_digital_employee_template_import` · `import_digital_employee_template_pack`
Cuenta, respuestas, archivos, colecciones	`get_me` · `list_agent_responses` · `resolve_durable_file_reference` · `update_file_visibility` · `get_memory_collection_ids`

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.

get_mission_control_usage

Devuelve el consumo de IA, las ejecuciones y la adopción del workspace en un período, en buckets en la zona horaria indicada, con agrupación, filtros y comparación con el período anterior opcionales. Misma consulta y permisos que el panel de Mission Control: quien llama ve solo su propio uso, el de su equipo o el workspace completo, según sus permisos mission-control:*. Referencia completa de parámetros y respuesta: Uso de Mission Control.

string

requerido

Inicio del período, fecha local (YYYY-MM-DD).

string

requerido

Fin del período, fecha local (YYYY-MM-DD), inclusive. El período dura como máximo 93 días.

string

Zona horaria IANA en la que se leen las fechas y los buckets (por defecto, la de la plataforma).

string

predeterminado:"day"

Tamaño del bucket de la serie: hour, day, week o month. Usa month para vistas generales.

string[]

Dimensiones de agrupación, máximo 3: agent, person, resource, resource_kind, execution_type, modality, activity_category, charge_type, execution_origin, trigger_source, agent_origin. Agrupar por person requiere mission-control:person-data:view.

string[]

Alias de persona (me, my_team, my_workspace) o ids de persona tomados de una respuesta anterior agrupada por person. Nunca inventes ids.

integer[]

Ids de equipo tomados de scope.teams de una respuesta anterior.

integer[]

Ids de agente tomados de una respuesta anterior agrupada por agent.

string[]

model, tool, connector, upload, kb, memory, voice u other. Combínalo con group_by[]=resource para “consumo por modelo”.

string

previous_period o previous_calendar_month: añade los totales del período anterior y el delta.

string

Id de la métrica que ordena los grupos (por defecto, la primera métrica pedida). sort_by (value, delta_abs, delta_pct) y order (desc, asc) lo afinan.

integer

predeterminado:"50"

Grupos por página (1–200). En conversación, mantén 10 o menos: la respuesta lleva una serie rellenada con ceros por grupo.

string

Cursor opaco de paginación tomado de page.next_cursor de una respuesta anterior.

Los rechazos llegan al asistente como error de la tool con el cuerpo de la API: los rechazos de consulta traen un code estable (window_too_large, no_team, person_data_not_allowed, usage_rollup_disabled, …); los rechazos de acceso traen solo message. Ejemplo de petición: “¿Cuánto gastamos por modelo este mes?” → el asistente llama a la tool con from/to cubriendo el mes, group_by[]=resource, filters[resource_kind][]=model, granularity=month y limit=10, y lee groups[].totals.consumption_net.

list_agent_versions

Returns a paginated list of published versions for an agent. Requires the agent:version:read permission. Each item includes change_summary and diff vs the immediately previous published version (API field names). Referencia completa: Listar Versiones del Agente.

get_agent_version

Returns the full details (including snapshot) of a specific agent version. Requires the agent:version:read permission. Referencia completa: Obtener Versión del Agente.

rollback_agent_version

Creates a new published version by restoring the snapshot of the target version, making it the active version. Requires access to edit the agent. Referencia completa: Rollback de Versión del Agente.

list_all_schedulers

Returns a paginated list of all schedulers for the authenticated user. Referencia completa: Listar todas las programaciones.

list_agent_schedulers

Returns a paginated list of schedulers for a specific agent. Referencia completa: Listar programaciones del agente.

create_agent_scheduler

Creates a new scheduler for a specific agent. Referencia completa: Crear programación.

get_agent_scheduler

Returns a single scheduler with next_run information. Referencia completa: Obtener programación.

update_agent_scheduler

Updates an existing scheduler. Referencia completa: Actualizar programación.

delete_agent_scheduler

Soft-deletes a scheduler. Referencia completa: Eliminar programación.

delete_scheduler_by_root_execution

Soft-deletes all schedulers that belong to the authenticated user, the given agent, and the given agent_root_id_execution within the current workspace. Referencia completa: Eliminar programaciones por ejecución raíz.

list_artifacts

Artifacts the token user created in the workspace, newest first. Paginated without a total: meta.has_more tells whether another page exists. Referencia completa: Listar artifacts.

create_artifact

Renders a new HTML artifact (version 1) from a template. Needs the artifact feature, a plan that includes artifacts and the Artifacts User permission (artifacts:create). Referencia completa: Crear artifact.

read_artifact

The head version with its HTML. Holders of the Artifacts Manager permission (artifacts:manage) may also read other members’ artifacts of the workspace, read-only; that read is audited. Referencia completa: Obtener artifact.

rename_artifact

Changes the title. No new version is written: a shared version keeps the title it was published with until a newer version is published. Referencia completa: Renombrar artifact.

delete_artifact

Soft-deletes the artifact, removes it from its chat and unpublishes it: its viewer, grants and public link stop working at once. Needs the Artifacts User permission (artifacts:create) and the workspace content-deletion permission (governance:content:delete). Referencia completa: Eliminar artifact.

edit_artifact

Applies patch operations to the head and writes a new version. Operations: replace (old, new), insert_before/insert_after (anchor, text), replace_range (from, to, new), prepend/append (text), and selector operations on one element of the content region: set_text (selector, text), replace_element (selector, html), set_attribute (selector, name, value), remove_element (selector). Anchors and selectors must match exactly once. Send base_version to get 409 ARTIFACT_STALE instead of editing a newer head. Referencia completa: Editar artifact.

publish_artifact_version

Makes one version (default: the head) the shared version that grants open. Who can open it is set with the share endpoint. Referencia completa: Publicar versión del artifact.

unpublish_artifact

Ends the active publication: no version is shared any more, and every access grant (people, teams, workspace and the public link) is deleted, so nobody but the owner and holders of the Artifacts Manager permission can open it. Sharing again starts fresh: the first grant publishes the latest version. Allowed to the owner, who may publish again later, and to holders of the Artifacts Manager permission (artifacts:manage) in the artifact’s workspace, whose unpublish the owner cannot undo. Referencia completa: Despublicar artifact.

restore_artifact_version

Writes an earlier version again as the new head; history is kept. The restored head is not shared until published. Referencia completa: Restaurar versión del artifact. Grants and revokes access in one all-or-nothing call. Granting needs the Artifacts User permission (artifacts:create) and stays within the sharer’s sharing restrictions, set on the Members page: the member’s own restriction, else the most permissive of their teams’, else the defaults (organization, workspace and teams on; public off). Targets: {type: user, user_id|email} (a person of this workspace needs the workspace level; a person from another workspace of the same organization needs the organization level, which exists only when the workspace belongs to one), {type: team, team_id} (only a team the sharer belongs to), {type: workspace}, {type: public}. The first grant publishes the head when nothing is shared yet. public (anyone with the link) opens for any signed-in Tess user, from any organization; anonymous visitors are sent to login first. Referencia completa: Compartir o dejar de compartir artifact.

list_artifact_versions

Version history, newest first, with the head and the shared (published) version marked. Referencia completa: Listar versiones del artifact.

delete_one_artifact_version

Deletes one version; its number is never reused. Deleting the head makes the newest remaining version the head. Deleting the shared version shares the newest remaining earlier version instead, or, with none earlier, stops sharing. The only remaining version cannot be deleted this way (422 ARTIFACT_LAST_VERSION): delete the artifact instead. Referencia completa: Eliminar versión del artifact.

list_artifact_templates

Templates new artifacts can be created from in this workspace: the global ones plus the workspace’s own (which win by slug). Referencia completa: Listar plantillas de artifact.

import_memories_text

Triggers memory import from free text. Async by default; optionally wait for completion with ?wait=true. Referencia completa: Importar recuerdos desde texto.

get_memory_import_status_result

Returns the status and summary for an import execution. Referencia completa: Obtener estado de la importación de recuerdos.

list_digital_employee_capabilities

Returns the effective capability map for the current user in the workspace. Referencia completa: Obtener capacidades.

list_digital_employees

Returns a paginated list of all digital employees in the workspace. Referencia completa: Listar Digital Employees.

create_standalone_digital_employee

Creates a new Digital Employee with a new host agent. Referencia completa: Crear empleado independiente.

create_digital_employee_agent

Creates a new Digital Employee linked to an existing agent. Referencia completa: Crear empleado desde un agente.

get_digital_employee

Returns a single digital employee with its main relations. Referencia completa: Obtener Digital Employee.

update_digital_employee

Updates one or more fields of an existing digital employee. Referencia completa: Actualizar Digital Employee.

duplicate_digital_employee

Creates a copy of an existing digital employee. Referencia completa: Duplicar Digital Employee.

delete_digital_employee

Soft-deletes a digital employee. The employee can be recovered. Referencia completa: Eliminar Digital Employee.

preview_digital_employee_schedule

Validates a schedule definition and returns the next planned occurrences. Referencia completa: Previsualizar programación.

invoke_digital_employee

Triggers a manual run of a digital employee. Referencia completa: Invocar Digital Employee.

retry_digital_employee_run

Re-executes a finished run of a digital employee. Referencia completa: Reintentar ejecución.

list_digital_employee_runs

Returns a paginated list of execution runs for a digital employee. Referencia completa: Listar ejecuciones.

get_digital_employee_run

Returns the details of a specific run. Referencia completa: Obtener ejecución.

get_digital_employee_run_output

Returns the consolidated output of a completed run. Referencia completa: Obtener salida de la ejecución.

pause_digital_employee

Pauses a digital employee, preventing new scheduled runs from starting. Referencia completa: Pausar Digital Employee.

resume_digital_employee

Resumes a paused digital employee, re-enabling scheduled runs. Referencia completa: Reanudar Digital Employee.

list_digital_employee_rollback_options

Returns the list of available versions to roll back to for a digital employee. Referencia completa: Obtener opciones de reversión.

rollback_digital_employee

Restores a digital employee to a previous version. Referencia completa: Revertir Digital Employee.

reparent_digital_employee

Assigns a new parent employee, making this employee a child of another. Referencia completa: Reasignar padre del Digital Employee.

detach_digital_employee

Removes the parent relationship, making this employee a top-level employee. Referencia completa: Desvincular Digital Employee.

get_digital_employee_run_summary

Returns aggregated statistics about the runs of a digital employee. Referencia completa: Obtener resumen de ejecuciones.

get_digital_employee_activity

Returns the activity log for a digital employee. Referencia completa: Obtener registro de actividad.

list_digital_employee_files

Returns the files associated with the most recent run of a digital employee. Referencia completa: Obtener archivos del empleado.

update_digital_employee_goal

Sets or updates the goal definition for a digital employee. Referencia completa: Actualizar objetivo.

approve_digital_employee

Approves a digital employee that is in pending_approval status. Referencia completa: Aprobar solicitud de contratación.

reject_digital_employee

Rejects a digital employee hire request in pending_approval status. Referencia completa: Rechazar solicitud de contratación.

upload_digital_employee_avatar

Uploads an avatar image for use with a digital employee. Referencia completa: Subir avatar.

export_digital_employee_template_pack

Exports a digital employee configuration as a portable template pack. Referencia completa: Exportar paquete de plantilla.

preview_digital_employee_template_import

Validates a template pack and returns a preview of what will be imported, including any conflicts. Referencia completa: Previsualizar importación de plantilla.

import_digital_employee_template_pack

Imports a template pack, creating or updating a digital employee from the pack configuration. Referencia completa: Importar paquete de plantilla.

get_me

Returns the name, e-mail, remaining credits and affiliate code of the user that owns the token. Referencia completa: Obtener usuario actual.

list_agent_responses

Returns a paginated list of agent executions (responses) of the workspace, newest last unless sorted. Referencia completa: Listar respuestas de agentes.

resolve_durable_file_reference

Resolves a durable doc://<universal_id> artifact reference into a freshly minted, short-lived signed download URL. Identity and workspace scope come from the authenticated API token and the resolved workspace context (header x-workspace-id), never from the body. Referencia completa: Resolver referencia de archivo.

update_file_visibility

Sets who can see a file: only its owner, the whole workspace, or anyone with the link. Referencia completa: Actualizar visibilidad del archivo.

get_memory_collection_ids

Returns a flat list of all memory collection IDs accessible by the authenticated user. Referencia completa: Listar IDs de colecciones.

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

​get_mission_control_usage

​list_agent_versions

​get_agent_version

​rollback_agent_version

​list_all_schedulers

​list_agent_schedulers

​create_agent_scheduler

​get_agent_scheduler

​update_agent_scheduler

​delete_agent_scheduler

​delete_scheduler_by_root_execution

​list_artifacts

​create_artifact

​read_artifact

​rename_artifact

​delete_artifact

​edit_artifact

​publish_artifact_version

​unpublish_artifact

​restore_artifact_version

​share_or_unshare_artifact

​list_artifact_versions

​delete_one_artifact_version

​list_artifact_templates

​import_memories_text

​get_memory_import_status_result

​list_digital_employee_capabilities

​list_digital_employees

​create_standalone_digital_employee

​create_digital_employee_agent

​get_digital_employee

​update_digital_employee

​duplicate_digital_employee

​delete_digital_employee

​preview_digital_employee_schedule

​invoke_digital_employee

​retry_digital_employee_run

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

get_mission_control_usage

list_agent_versions

get_agent_version

rollback_agent_version

list_all_schedulers

list_agent_schedulers

create_agent_scheduler

get_agent_scheduler

update_agent_scheduler

delete_agent_scheduler

delete_scheduler_by_root_execution

list_artifacts

create_artifact

read_artifact

rename_artifact

delete_artifact

edit_artifact

publish_artifact_version

unpublish_artifact

restore_artifact_version

share_or_unshare_artifact

list_artifact_versions

delete_one_artifact_version

list_artifact_templates

import_memories_text

get_memory_import_status_result

list_digital_employee_capabilities

list_digital_employees

create_standalone_digital_employee

create_digital_employee_agent

get_digital_employee

update_digital_employee

duplicate_digital_employee

delete_digital_employee

preview_digital_employee_schedule

invoke_digital_employee

retry_digital_employee_run

list_digital_employee_runs

get_digital_employee_run

get_digital_employee_run_output

pause_digital_employee

resume_digital_employee

list_digital_employee_rollback_options

rollback_digital_employee

reparent_digital_employee

detach_digital_employee

get_digital_employee_run_summary