# MCP da Zaia: opere o workspace no Cursor ou Claude

Conecte ChatGPT, Cursor ou Claude ao MCP first-party da Zaia e monte agentes, publique versões e consulte o workspace com a chave de API do cliente.

Autor: Felipe Bedani (Produto)
Publicado em 2026-10-22 · Tags: mcp, integracoes, produto

---

Quem monta e opera agentes para clientes pode conectar Cursor, Claude ou ChatGPT ao **MCP da Zaia** e tratar o workspace Endless como catálogo de tools: listar agentes, editar rascunho, publicar versão e consultar analytics com a mesma chave de API que você já gera no Console. O ganho é operacional — menos ida e volta na UI quando o trabalho já está no chat do assistente.

## O que é MCP da Zaia

O **MCP da Zaia** é o servidor MCP **first-party** da Endless em `https://api.endless.zaia.app/api/v1/mcp`. Cada conexão opera **um workspace**, identificado pela **Chave de API** (recurso em **beta**). Não substitui os MCPs do catálogo que o Agente consome no Builder (Google Calendar, Notion, Slack); é o caminho inverso — a Zaia expõe o workspace para o cliente MCP externo.

## O problema que ela resolve

Montar agente, squad, tool, canal e base de conhecimento no Console funciona, mas quem já vive no Cursor ou no Claude repete os mesmos passos em telas diferentes. Para entregar mais rápido ao cliente, falta um jeito seguro de **operar o workspace** a partir do assistente: ler o que existe, escrever no rascunho, publicar só quando você confirmar e puxar números sem montar dashboard na mão.

## Como funciona

1. No workspace do cliente, abra **Configurações → Integrações → Chaves de API** e clique em **Nova Chave de API**. Copie a chave — o MCP **não cria** chave por você.
2. No cliente MCP (por exemplo Cursor), aponte o servidor para `https://api.endless.zaia.app/api/v1/mcp` e envie a chave no header `Authorization` (`Bearer <uuid>` ou UUID cru). O workspace vem **sempre** da chave.

![Ilustração da tela Chaves de API, com o botão Nova Chave de API e uma chave nomeada para integração externa](../../assets/blog-lancamentos/operar-workspace-via-mcp/chaves-api.png)

3. Depois de conectar, peça ao assistente para chamar **`explain_zaia`** antes de qualquer escrita. Ela devolve guias por tópico (`overview`, `agent`, `squad`, `tool`, `channel`, `workflow` em **beta**, `insights`, `dashboard`, `deploy`).

![Ilustração da tela explain_zaia, com tópicos overview, agent e deploy para orientar o assistente](../../assets/blog-lancamentos/operar-workspace-via-mcp/explain-zaia.png)

4. Fluxo típico: `explain_zaia` → `list_agents` / `list_tools` → criar ou atualizar no **rascunho** (agentes, squads, tools, prompts condicionais como *tasks*) → **`deploy_version`** com `confirm: true` quando você concordar com a publicação.

![Ilustração da tela de publicação, com agente em rascunho antes de ir para produção](../../assets/blog-lancamentos/operar-workspace-via-mcp/publicar-rascunho.png)

5. Canais, tags, conhecimento, tabelas, views de kanban e automações do Console entram **ao vivo** (automações nascem **inativas**). **Workflows** (**beta**) usam `deploy_workflow` com confirmação e **`activate_workflow`** — não usam `deploy_version`.
6. Para leitura, `list_dashboard_scope` / `generate_dashboard` e o fluxo de **Insights** (`estimate_insights`, depois `create_insights` com `confirmationToken`) seguem as mesmas regras de período e créditos do Console.

O passo a passo completo, exemplos de configuração e relação com a Developer Platform API (**alpha — sujeita a mudanças**) estão em [Operar o workspace via MCP da Zaia](/docs/mcps/operating-workspace-via-mcp/).

## O que você consegue entregar com isso

Exemplos ilustrativos:

- **Onboarding de workspace pelo assistente:** no Cursor, listar agentes existentes, criar rascunho de um agente de qualificação e publicar só depois da sua revisão no chat.
- **Operação de entrega:** ajustar tags, bases de conhecimento e tabelas do cliente sem abrir dez abas do Builder — útil quando você mantém vários workspaces.
- **Relato para o cliente:** gerar série de dashboard ou rodar Insights pelo MCP e colar o resumo na proposta ou no check-in semanais (respeitando créditos e limites de período).

## Limites

- Uma chave = um workspace. O cliente MCP não escolhe workspace em argumentos de tool.
- O MCP não cria chave de API, não envia mensagem ao cliente final, não executa agente/squad/workflow/automação e não apaga recursos.
- Não move cards de kanban nem abre o board ao vivo; views de kanban são metadados.
- Não cadastra MCP customizado nem gerencia billing, cancelamento ou secrets de LLM.
- Dashboard gerado não altera o layout salvo no Console. Série horária até 7 dias; período total até 180 dias, sem data futura.
- Transporte HTTP streamable stateless — não há SSE iniciado pelo servidor.

## Perguntas frequentes

### Isso substitui conectar Google Calendar ou Slack no Builder?

Não. [O que são MCPs?](/docs/mcps/what-are-mcps/) continua valendo para integrações **dentro** do workspace. O MCP da Zaia opera **o** workspace a partir de fora (Cursor, Claude, ChatGPT).

### Preciso usar a API REST em vez do MCP?

Os dois usam a mesma credencial de workspace. A [Developer Platform API](/api-reference/) permanece **alpha**. Prefira o MCP quando quem opera é um assistente com catálogo de tools; prefira REST quando você controla o código da integração.

### Agentes criados pelo MCP já vão direto para produção?

Não. Agentes, squads e tools ficam em **rascunho** até **`deploy_version`** com `confirm: true`. Canais, tags, conhecimento e tabelas entram ao vivo.

### O que são prompts condicionais no MCP?

São *tasks* do agente no rascunho (`list_tasks`, `create_task`, `update_task` com `name`, `condition` e `prompt`), o mesmo conceito de [Prompts condicionais](/docs/agents/agent-settings/conditional-prompts/) no Console. Publicam com `deploy_version`.

## Próximo passo

Leia [Operar o workspace via MCP da Zaia](/docs/mcps/operating-workspace-via-mcp/) e, para integrações que o Agente consome, [Como Conectar um Novo MCP](/docs/mcps/how-to-connect-a-new-mcp/). Para encaixar entrega multicanal na sua oferta, veja o hub [como vender agente de IA](/blog/como-vender-agente-de-ia/).

[Iniciar teste de 7 dias](https://endless.zaia.app/platform/authenticate) <!-- pragma: allowlist secret --> — sem cartão. Planos a partir de R$125 por slot/mês no anual.