Skip to main content
Saga está disponível como servidor MCP, para que agentes e assistentes de IA — Claude, ChatGPT, Cursor e agentes personalizados — possam usar o seu espaço de trabalho do Saga como uma ferramenta. O agente pode fazer perguntas ao Saga, pesquisar e ler documentos de projetos e executar os seus fluxos de trabalho, tudo utilizando o seu próprio acesso. Isto é o inverso de ligar servidores MCP externos ao Saga. Aqui, o seu espaço de trabalho do Saga é o servidor ao qual as outras ferramentas se ligam.

​
Antes de começar

Precisa de:
  • A sua URL da plataforma e uma chave API. Ambas provêm de Configurações > Gestão de chaves API dentro do Saga. Abra a página, crie uma chave se não tiver uma e copie ambos os valores.
  • Um cliente MCP que suporte o transporte HTTP por streaming (Claude Desktop, Claude Code, Cursor ou qualquer agente personalizado criado sobre o SDK MCP).
Cada cliente tem o seu próprio domínio Saga, por isso o seu endpoint MCP é a sua própria URL da plataforma com /api/mcp adicionado. Use a URL da plataforma apresentada em Configurações > Gestão de chaves API — não adivinhe o domínio.

​
Ligar um cliente

A maioria dos clientes só precisa da URL do endpoint e de um cabeçalho Authorization.
  • Endpoint: https://<your-domain>.sagalegal.io/api/mcp
  • Cabeçalho: Authorization: Api-Key <your-api-key>
Para um cliente que lê um ficheiro .mcp.json (por exemplo, o Claude Code), adicione:
Substitua <your-domain> pela sua URL da plataforma e <your-api-key> pela chave de Configurações > Gestão de chaves API.
Alguns clientes só lhe permitem colar um token bearer. Nesse caso, use Authorization: Bearer <your-api-key> em vez disso — o Saga aceita a sua chave API em qualquer um dos formatos.

​
O que o agente pode fazer

Uma vez ligado, o agente dispõe destas ferramentas: Cada ferramenta é executada em seu nome. O agente vê apenas os projetos, documentos e fluxos de trabalho a que a sua conta já pode aceder — as mesmas permissões que tem na aplicação web.

​
Segurança

  • Trate a sua chave API como uma palavra-passe. Qualquer pessoa com a chave e a sua URL da plataforma pode agir em seu nome através do Saga.
  • Renove ou revogue a chave a qualquer momento em Configurações > Gestão de chaves API. Revogá-la interrompe imediatamente qualquer agente ligado.
  • Se uma chave possa ter sido divulgada, revogue-a e crie uma nova, depois atualize a configuração do seu cliente.

​
Resolução de problemas

  • O cliente não consegue ligar-se ou devolve 401 Unauthorized — verifique se o endpoint termina em /api/mcp, se o cabeçalho é Authorization: Api-Key <your-api-key> e se a chave não expirou nem foi revogada. Crie uma nova chave em Configurações > Gestão de chaves API se necessário.
  • Um fluxo de trabalho aparece como pausado — os fluxos de trabalho que aguardam input a meio do processo não podem ser retomados via MCP, e os inputs de ficheiros não são suportados. Execute-os a partir da aplicação Saga em vez disso.