Servidor MCP - Tess AI Docs

O Servidor MCP da Tess AI transforma seus agentes, execuções e memórias da Tess em ferramentas que qualquer cliente do Model Context Protocol (MCP) pode chamar. É um endpoint hospedado e gerenciado: não há nada para instalar, empacotar ou executar. Aponte sua plataforma de IA para uma única URL, autentique-se com o seu token de API da Tess e sua equipe poderá listar, executar e orquestrar agentes da Tess diretamente nas ferramentas que já utiliza.

Endpoint: https://mcp.tess.im — um servidor MCP remoto que usa o transporte Streamable HTTP. Sem npx, sem processo local, sem necessidade de Node.js.

Servidor MCP da Tess

Esta página. Exponha agentes, arquivos e memórias da Tess para Claude, Cursor, Codex ou qualquer cliente MCP.

Custom MCP

O outro sentido: conecte servidores MCP externos ao chat e aos agentes da Tess, com escopo pessoal ou compartilhado.

Por que conectar via MCP

Use a Tess onde sua equipe já trabalha

Execute agentes da Tess de dentro do Claude, Cursor, Codex ou suas próprias ferramentas internas — sem troca de contexto, sem copiar e colar.

Zero instalação, sempre atualizado

Um endpoint gerenciado mantido pela Tess. Novos recursos aparecem automaticamente; não há cliente para atualizar.

Governado pelo seu workspace

Cada chamada é executada com o token e o workspace de quem chama, herdando suas funções, permissões e limites de créditos existentes.

Padronizado e portátil

Construído sobre o protocolo aberto MCP. O mesmo endpoint funciona em todas as plataformas compatíveis — sem integração por fornecedor.

O que o servidor expõe

O conjunto de ferramentas é uma lista explícita da API pública da Tess — os mesmos endpoints documentados em Visão geral da API. Novas capacidades da API só aparecem como ferramentas MCP depois de entrar nessa superfície pública. Todas as ferramentas estão listadas abaixo, agrupadas por domínio, cada uma com sua própria entrada linkável em Referência das ferramentas.

Domínio	Ferramentas
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`
Arquivos	`list_files` · `upload_file` · `get_file` · `delete_file` · `process_file`
Memórias	`list_memories` · `create_memory` · `update_memory` · `delete_memory`
Coleções de memória	`list_memory_collections` · `create_memory_collection` · `update_memory_collection` · `delete_memory_collection`
Webhooks	`list_webhooks` · `delete_webhook`
Workspace e auditoria	`get_workspace_usage` · `list_audit_events`
Mission Control	`get_mission_control_usage`
Versões de agente	`list_agent_versions` · `get_agent_version` · `rollback_agent_version`
Agendamentos 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`
Importação de memórias	`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`
Conta, respostas, arquivos, coleções	`get_me` · `list_agent_responses` · `resolve_durable_file_reference` · `update_file_visibility` · `get_memory_collection_ids`

A lista corresponde à API pública. Endpoints internos só de sessão nunca viram ferramentas MCP. Peça ao assistente para listar as ferramentas disponíveis se quiser confirmar o conjunto ao vivo no seu cliente.

Antes de começar

Você precisa de duas informações da plataforma Tess:

Seu token de API

Gere um token de acesso pessoal em Tess AI → Tokens de API. É o mesmo token usado em toda a API da Tess — veja o Quickstart para detalhes.

O ID do seu workspace

O servidor MCP é escopado por workspace. Encontre o ID do seu workspace na URL do painel da Tess ou nas configurações do workspace, e use o do workspace cujos agentes você deseja acessar. Cada chamada fica isolada a esse workspace.

Trate seu token de API como uma senha. Ele concede acesso aos agentes e execuções do seu workspace, que podem consumir créditos. Prefira um token dedicado por integração para poder revogá-lo de forma independente.

Autenticação

As credenciais são enviadas apenas como cabeçalhos HTTP — nunca como parâmetros de URL, para que tokens não fiquem em logs ou no histórico do navegador:

Authorization: Bearer SEU_TOKEN_DE_API
x-workspace-id: SEU_WORKSPACE_ID

Os dois cabeçalhos são obrigatórios em toda requisição. Obrigatório a partir de 01/09/2026 para o escopo de workspace da API Tess (mesma política do header da API REST). Não há alternativa via parâmetro de URL — seu cliente MCP precisa suportar o envio de cabeçalhos personalizados.

Conecte sua plataforma

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

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

Depois, em uma sessão: “Use a Tess para executar o agente de Code Review neste diff.”Configurações JSON remotas precisam de type definido como http (ou streamable-http). Uma url sem type é ignorada como servidor stdio quebrado.

Adicione a Tess à sua configuração MCP (no Cursor: Tools & Integrations → MCP Tools, ou ~/.cursor/mcp.json):

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

Prefira interpolar uma variável de ambiente para o token em vez de gravá-lo em texto puro. O Cursor resolve interpolação de env em url e headers.

Adicione um servidor MCP remoto com cabeçalhos em ~/.codex/config.toml:

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

A sintaxe de configuração pode mudar entre versões do Codex CLI — confira codex mcp --help ou a documentação atual do Codex se isso não corresponder ao que você vê.

Essas plataformas se conectam a servidores MCP remotos por meio de uma interface de “conector personalizado”. Para funcionar com a Tess, a configuração do conector precisa permitir definir duas coisas:

A URL do endpoint: https://mcp.tess.im
Dois cabeçalhos personalizados: Authorization: Bearer SEU_TOKEN_DE_API e x-workspace-id: SEU_WORKSPACE_ID

Algumas interfaces de conector só expõem um único campo de bearer token e não suportam adicionar um segundo cabeçalho personalizado — confira a documentação atual da sua plataforma para saber se cabeçalhos personalizados (além de um bearer token) são suportados para conectores MCP remotos. Se sua plataforma suportar apenas um cabeçalho de autenticação, use um dos clientes com suporte a cabeçalhos acima (Claude Code, Cursor, Codex CLI) ou uma integração personalizada.

Como funciona a autenticação

O servidor MCP é um gateway sem estado. Ele não armazena suas credenciais. A cada requisição ele:

Lê seu token de API e o ID do workspace a partir dos cabeçalhos da requisição.
Encaminha a chamada para a API da Tess como você, exatamente como uma chamada direta à API faria.
Retorna o resultado ao seu cliente MCP.

Isso significa que o servidor herda todos os controles existentes da sua plataforma:

Identidade e permissões

As chamadas rodam com a identidade do dono do token. Visibilidade de agentes, funções e permissões de recursos são aplicadas pela Tess, sem atalhos.

Isolamento de workspace

Cada requisição é vinculada ao x-workspace-id enviado. Um token não alcança dados de outro workspace.

Governança de créditos

As execuções consomem créditos sob os limites e a cobrança do seu workspace — igual à API da Tess.

Acesso revogável

Revogue um token no painel para cortar instantaneamente qualquer plataforma conectada que o utilize. Sem necessidade de redeploy.

Referência das ferramentas

list_agents

Lista os agentes disponíveis no workspace, com busca e paginação.

string

Busca agentes por título, descrição e descrição longa.

string

Filtra por tipo de agente.

integer

padrão:"1"

Número da página para paginação.

integer

padrão:"15"

Quantidade de agentes por página.

get_agent

Retorna os detalhes completos de um agente (entradas, tipo, descrição).

string | integer

obrigatório

O ID do agente.

execute_agent

Executa um agente com as entradas fornecidas e, opcionalmente, aguarda o resultado.

string | integer

obrigatório

O ID do agente.

object

obrigatório

As respostas do agente. Para agentes do tipo chat, inclua um array messages (pares role/content, no mesmo formato do OpenAI Chat Completions).

boolean

padrão:"false"

Quando true, aguarda o término da execução e retorna a saída final. Quando false, retorna imediatamente para que você consulte a execução depois.

list_files_agent

Obtém a lista de arquivos associados a um agente específico.

integer

obrigatório

ID do agente para o qual recuperar os arquivos.

link_files_agent

Associa um ou mais arquivos a um agente específico.

integer

obrigatório

ID do agente ao qual vincular os arquivos.

integer[]

obrigatório

Array de IDs de arquivos a vincular ao agente.

delete_file_link_agent

Remove a associação entre um arquivo específico e um agente.

integer

obrigatório

ID do agente do qual remover o vínculo do arquivo.

integer

obrigatório

ID do arquivo a desvincular do agente.

get_agent_response

Obtém uma resposta de execução de agente específica pelo ID.

string | integer

obrigatório

O ID da execução do agente.

list_agent_webhooks

Lista os webhooks registrados para um agente específico.

integer

obrigatório

ID do agente.

integer

padrão:"1"

Página atual.

integer

padrão:"15"

Quantidade de itens por página.

create_agent_webhook

Registra um novo webhook em um agente específico.

string | integer

obrigatório

O ID do agente.

string

A URL de destino do webhook.

string

padrão:"POST"

Método HTTP usado na chamada do webhook.

string

padrão:"active"

Status do webhook (active/inativo).

list_files

Obtém uma lista paginada de arquivos do workspace, com opções de ordenação.

integer

padrão:"1"

Número da página para paginação.

integer

padrão:"15"

Quantidade de itens por página (máx. 100).

string

padrão:"desc"

Ordem de classificação pelo campo created_at (asc/desc).

upload_file

Envia um novo arquivo ao workspace e opcionalmente o processa.

binary

obrigatório

O arquivo a enviar.

boolean

padrão:"false"

Se o arquivo deve ser processado imediatamente após o envio.

get_file

Retorna os detalhes de um arquivo específico.

integer

obrigatório

O ID do arquivo.

delete_file

Exclui um arquivo do workspace.

integer

obrigatório

O ID do arquivo.

process_file

Aciona (ou reaciona) o processamento de um arquivo já enviado.

integer

obrigatório

O ID do arquivo.

list_memories

Lista as memórias armazenadas no workspace.

integer

Filtra por coleção de memórias.

integer

padrão:"1"

Número da página para paginação.

integer

padrão:"10"

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

create_memory

Salva uma nova memória em uma coleção.

integer

A coleção de memórias onde armazenar.

string

O texto da memória a armazenar (máx. 32.000 caracteres).

update_memory

Edita uma memória existente.

integer

obrigatório

A memória a atualizar.

string

Novo texto da memória.

integer

Move a memória para outra coleção.

delete_memory

Remove uma memória existente.

integer

obrigatório

A memória a excluir.

list_memory_collections

Lista as coleções de memória do workspace.

string

Filtra coleções por nome.

integer

padrão:"1"

Número da página.

integer

padrão:"12"

Itens por página (1–50).

create_memory_collection

Cria uma coleção de memória.

string

obrigatório

Nome da coleção.

string

Descrição opcional.

update_memory_collection

Atualiza uma coleção de memória.

integer

obrigatório

A coleção a atualizar.

string

Novo nome.

string

Nova descrição.

delete_memory_collection

Exclui uma coleção de memória.

integer

obrigatório

A coleção a excluir.

list_webhooks

Lista todos os webhooks do workspace.

integer

padrão:"1"

Página atual.

integer

padrão:"15"

Quantidade de itens por página.

delete_webhook

Exclui um webhook pelo ID.

integer

obrigatório

O ID do webhook.

get_workspace_usage

Retorna o uso do workspace detalhado por tipo e intervalo de datas.

string

Filtro de intervalo de datas predefinido (1d/7d/30d).

string

Data inicial personalizada (YYYY-MM-DD). Use com end_date; sobrepõe range.

string

Data final personalizada (YYYY-MM-DD). Use com start_date; sobrepõe range.

integer

Filtra por ID de usuário (requer a permissão WORKSPACE_DOCUMENTS_READ).

string

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

integer

padrão:"1"

Número da página para paginação.

list_audit_events

Busca eventos de auditoria do workspace para ingestão em SIEM. A janela de tempo é obrigatória e não pode ultrapassar 30 dias.

string

obrigatório

Início da janela (YYYY-MM-DD).

string

obrigatório

Fim da janela (YYYY-MM-DD). Deve estar a no máximo 30 dias de from.

integer

padrão:"50"

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

string

Cursor opaco de paginação da resposta anterior.

string

Filtra pela origem (auditable ou activity).

string

Filtra por tipo de evento.

integer

Filtra pelo ator.

list_audit_events

Busca eventos de auditoria do workspace para ingestão em SIEM. A janela de tempo é obrigatória e não pode ultrapassar 30 dias.

string

obrigatório

Início da janela (YYYY-MM-DD).

string

obrigatório

Fim da janela (YYYY-MM-DD). Deve estar a no máximo 30 dias de from.

integer

padrão:"50"

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

string

Cursor opaco de paginação da resposta anterior.

string

Filtra pela origem (auditable ou activity).

string

Filtra por tipo de evento.

integer

Filtra pelo ator.

get_mission_control_usage

Retorna o consumo de IA, as execuções e a adoção do workspace em um período, em buckets no fuso informado, com agrupamento, filtros e comparação com o período anterior opcionais. Mesma consulta e permissões do painel do Mission Control: quem chama vê só o próprio uso, o do seu time ou o workspace inteiro, conforme as permissões mission-control:*. Referência completa de parâmetros e resposta: Uso do Mission Control.

string

obrigatório

Início do período, data local (YYYY-MM-DD).

string

obrigatório

Fim do período, data local (YYYY-MM-DD), inclusivo. O período tem no máximo 93 dias.

string

Fuso IANA em que as datas e os buckets são lidos (padrão: o fuso da plataforma).

string

padrão:"day"

Tamanho do bucket da série: hour, day, week ou month. Use month para visões gerais.

string[]

Dimensões de agrupamento, no máximo 3: agent, person, resource, resource_kind, execution_type, modality, activity_category, charge_type, execution_origin, trigger_source, agent_origin. Agrupar por person exige mission-control:person-data:view.

string[]

Aliases de pessoa (me, my_team, my_workspace) ou ids de pessoa vindos de uma resposta anterior agrupada por person. Nunca invente ids.

integer[]

Ids de time vindos de scope.teams de uma resposta anterior.

integer[]

Ids de agente vindos de uma resposta anterior agrupada por agent.

string[]

model, tool, connector, upload, kb, memory, voice ou other. Combine com group_by[]=resource para “consumo por modelo”.

string

previous_period ou previous_calendar_month: adiciona os totais do período anterior e o delta.

string

Id da métrica que ordena os grupos (padrão: a primeira métrica pedida). sort_by (value, delta_abs, delta_pct) e order (desc, asc) refinam.

integer

padrão:"50"

Grupos por página (1–200). Em conversa, mantenha 10 ou menos: a resposta traz uma série preenchida com zeros por grupo.

string

Cursor opaco de paginação vindo de page.next_cursor de uma resposta anterior.

As recusas chegam ao assistente como erro da tool com o corpo da API: recusas de consulta trazem um code estável (window_too_large, no_team, person_data_not_allowed, usage_rollup_disabled, …); recusas de acesso trazem só message. Exemplo de pedido: “Quanto gastamos por modelo este mês?” → o assistente chama a tool com from/to cobrindo o mês, group_by[]=resource, filters[resource_kind][]=model, granularity=month e limit=10, e lê 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). Referência completa: Listar Versões do Agente.

get_agent_version

Returns the full details (including snapshot) of a specific agent version. Requires the agent:version:read permission. Referência completa: Obter Versão do 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. Referência completa: Rollback de Versão do Agente.

list_all_schedulers

Returns a paginated list of all schedulers for the authenticated user. Referência completa: Listar todos os agendamentos.

list_agent_schedulers

Returns a paginated list of schedulers for a specific agent. Referência completa: Listar agendamentos do agente.

create_agent_scheduler

Creates a new scheduler for a specific agent. Referência completa: Criar agendamento.

get_agent_scheduler

Returns a single scheduler with next_run information. Referência completa: Obter agendamento.

update_agent_scheduler

Updates an existing scheduler. Referência completa: Atualizar agendamento.

delete_agent_scheduler

Soft-deletes a scheduler. Referência completa: Excluir agendamento.

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. Referência completa: Excluir agendamentos por execução raiz.

list_artifacts

Artifacts the token user created in the workspace, newest first. Paginated without a total: meta.has_more tells whether another page exists. Referência 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). Referência completa: Criar 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. Referência completa: Obter 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. Referência completa: Renomear 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). Referência completa: Excluir 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. Referência 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. Referência completa: Publicar versão do 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. Referência 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. Referência completa: Restaurar versão do 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. Referência completa: Compartilhar ou descompartilhar artifact.

list_artifact_versions

Version history, newest first, with the head and the shared (published) version marked. Referência completa: Listar versões do 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. Referência completa: Excluir versão do 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). Referência completa: Listar modelos de artifact.

import_memories_text

Triggers memory import from free text. Async by default; optionally wait for completion with ?wait=true. Referência completa: Importar memórias de texto.

get_memory_import_status_result

Returns the status and summary for an import execution. Referência completa: Obter status da importação de memórias.

list_digital_employee_capabilities

Returns the effective capability map for the current user in the workspace. Referência completa: Verificar Capacidades.

list_digital_employees

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

create_standalone_digital_employee

Creates a new Digital Employee with a new host agent. Referência completa: Criar Employee Standalone.

create_digital_employee_agent

Creates a new Digital Employee linked to an existing agent. Referência completa: Criar Employee a partir de Agente.

get_digital_employee

Returns a single digital employee with its main relations. Referência completa: Obter Digital Employee.

update_digital_employee

Updates one or more fields of an existing digital employee. Referência completa: Atualizar Digital Employee.

duplicate_digital_employee

Creates a copy of an existing digital employee. Referência completa: Duplicar Digital Employee.

delete_digital_employee

Soft-deletes a digital employee. The employee can be recovered. Referência completa: Deletar Digital Employee.

preview_digital_employee_schedule

Validates a schedule definition and returns the next planned occurrences. Referência completa: Prévia de Agendamento.

invoke_digital_employee

Triggers a manual run of a digital employee. Referência completa: Invocar Digital Employee.

retry_digital_employee_run

Re-executes a finished run of a digital employee. Referência completa: Retentar Execução.

list_digital_employee_runs

Returns a paginated list of execution runs for a digital employee. Referência completa: Listar Execuções.

get_digital_employee_run

Returns the details of a specific run. Referência completa: Obter Execução.

get_digital_employee_run_output

Returns the consolidated output of a completed run. Referência completa: Saída da Execução.

pause_digital_employee

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

resume_digital_employee

Resumes a paused digital employee, re-enabling scheduled runs. Referência completa: Retomar Digital Employee.

list_digital_employee_rollback_options

Returns the list of available versions to roll back to for a digital employee. Referência completa: Opções de Rollback.

rollback_digital_employee

Restores a digital employee to a previous version. Referência completa: Rollback de Digital Employee.

reparent_digital_employee

Assigns a new parent employee, making this employee a child of another. Referência completa: Reatribuir Parent.

detach_digital_employee

Removes the parent relationship, making this employee a top-level employee. Referência completa: Desanexar Digital Employee.

get_digital_employee_run_summary

Returns aggregated statistics about the runs of a digital employee. Referência completa: Resumo das Execuções.

get_digital_employee_activity

Returns the activity log for a digital employee. Referência completa: Log de Atividade.

list_digital_employee_files

Returns the files associated with the most recent run of a digital employee. Referência completa: Arquivos do Employee.

update_digital_employee_goal

Sets or updates the goal definition for a digital employee. Referência completa: Atualizar Objetivo.

approve_digital_employee

Approves a digital employee that is in pending_approval status. Referência completa: Aprovar Contratação.

reject_digital_employee

Rejects a digital employee hire request in pending_approval status. Referência completa: Rejeitar Contratação.

upload_digital_employee_avatar

Uploads an avatar image for use with a digital employee. Referência completa: Upload de Avatar.

export_digital_employee_template_pack

Exports a digital employee configuration as a portable template pack. Referência completa: Exportar Template Pack.

preview_digital_employee_template_import

Validates a template pack and returns a preview of what will be imported, including any conflicts. Referência completa: Prévia de Importação de Template.

import_digital_employee_template_pack

Imports a template pack, creating or updating a digital employee from the pack configuration. Referência completa: Importar Template Pack.

get_me

Returns the name, e-mail, remaining credits and affiliate code of the user that owns the token. Referência completa: Obter usuário atual.

list_agent_responses

Returns a paginated list of agent executions (responses) of the workspace, newest last unless sorted. Referência completa: Listar respostas 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. Referência completa: Resolver referência de arquivo.

update_file_visibility

Sets who can see a file: only its owner, the whole workspace, or anyone with the link. Referência completa: Atualizar visibilidade do arquivo.

get_memory_collection_ids

Returns a flat list of all memory collection IDs accessible by the authenticated user. Referência completa: Listar IDs das coleções.

Exemplo: execute um agente de ponta a ponta

Após conectar, você pode conduzir um fluxo completo em linguagem natural:

Descubra os agentes

“Liste meus agentes da Tess” → o assistente chama list_agents e mostra o que está disponível.

Capture contexto como memória

“Salve na minha coleção ‘Padrões de Engenharia’: sempre escreva testes unitários com BDD” → create_memory.

Execute um agente

“Use o agente de Code Review para revisar esta função, e aguarde o resultado” → execute_agent retorna a saída na hora.

Reutilize depois

“Liste minhas memórias” → list_memories confirma o que está armazenado para execuções futuras.

Governança e conformidade

Privilégio mínimo — conecte-se com um token escopado a um único workspace e apenas com as permissões necessárias àquela integração.
Auditabilidade — execuções disparadas via MCP aparecem no histórico e no uso do seu workspace na Tess, como qualquer chamada de API.
Sem armazenamento de credenciais — o gateway é sem estado; os tokens ficam apenas na configuração do seu cliente MCP.
Revogação centralizada — desativar um token no painel bloqueia imediatamente todas as plataformas que o utilizam.

Solução de problemas

O cliente conecta mas nenhuma ferramenta aparece

Confirme que seu cliente usa o transporte Streamable HTTP (remoto) em vez de um comando local/stdio, e que está apontado diretamente para https://mcp.tess.im (sem caminho extra). No Claude Code, entradas JSON remotas também precisam de type definido como http.

Erros 401 / 'não autorizado'

Os dois cabeçalhos são obrigatórios em toda requisição — Authorization: Bearer SEU_TOKEN_DE_API e x-workspace-id: SEU_WORKSPACE_ID. Não há opção via parâmetro de URL; confirme que seu cliente suporta o envio de cabeçalhos personalizados e que o token está ativo no painel.

Erros 404 ou de 'workspace'

O ID do workspace está ausente, malformado, ou o token não tem acesso a ele. Confirme que o cabeçalho x-workspace-id está definido e corresponde a um workspace acessível pelo seu token.

Um agente falha ao executar

Alguns agentes exigem entradas específicas. Agentes do tipo chat, por exemplo, esperam um array messages dentro de body. Peça ao assistente para inspecionar os campos do agente (get_agent), ou verifique o agente na plataforma Tess.

Recursos

Custom MCP — conecte servidores MCP externos à Tess
Compartilhamento e permissões
Boas práticas de MCP
Model Context Protocol — site oficial
Como criar um Token de API na Tess AI

Servidor MCP da Tess

Custom MCP

​Por que conectar via MCP

Use a Tess onde sua equipe já trabalha

Zero instalação, sempre atualizado

Governado pelo seu workspace

Padronizado e portátil

​O que o servidor expõe

​Antes de começar

​Autenticação

​Conecte sua plataforma

​Como funciona a autenticação

Identidade e permissões

Isolamento de workspace

Governança de créditos

Acesso revogável

​Referência das ferramentas

​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

​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

Por que conectar via MCP

O que o servidor expõe

Antes de começar

Autenticação

Conecte sua plataforma

Como funciona a autenticação

Referência das ferramentas

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

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