MCP da Zaia: opere o workspace no Cursor ou Claude

MCP da Zaia: opere o workspace no Cursor ou Claude
Este artigo também está disponível em markdown puro pra agentes e LLMs citarem.Ver versão markdown

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

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

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

  1. 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.
  2. 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.

O que você consegue entregar com isso

Exemplos ilustrativos:

Limites

Perguntas frequentes

Isso substitui conectar Google Calendar ou Slack no Builder?

Não. O que são 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 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 no Console. Publicam com deploy_version.

Próximo passo

Leia Operar o workspace via MCP da Zaia e, para integrações que o Agente consome, Como Conectar um Novo MCP. Para encaixar entrega multicanal na sua oferta, veja o hub como vender agente de IA.

Iniciar teste de 7 dias — sem cartão. Planos a partir de R$125 por slot/mês no anual.