// Documentação

Conector Orkestra para o Claude

Leve o board, a memória da organização, as simulações e a operação da suíte Orkestra para dentro do Claude — no claude.ai, no Claude Desktop e no Claude Code.

O que é

Um servidor MCP remoto que dá ao Claude acesso aos dados da sua conta Orkestra: 47 ferramentas para consultar tarefas, objetivos, documentação, memória da organização, deploys e pull requests, e para criar ou atualizar tarefas, comentários, páginas e decisões. Tudo com as permissões que a sua conta já tem.

Como conectar

Endereço do conector:

https://mcp.orkestraai.com.br/mcp/conector
  • claude.ai e Claude Desktop — em Configurações › Conectores, adicione o Orkestra pelo diretório (ou como conector personalizado, com o endereço acima) e clique em Conectar.
  • Claude Code — claude mcp add --transport http orkestra https://mcp.orkestraai.com.br/mcp/conector, depois /mcp para entrar.

O login abre no navegador, na página do Orkestra Padlock: você entra com a sua conta Orkestra e aprova o acesso. O conector usa OAuth 2.1 com PKCE; a senha nunca passa pelo Claude. O acesso à suíte é por convite: sem conta, peça a um administrador da sua organização ou escreva para contato@orkestraai.com.br.

As 47 ferramentas

Cada ferramenta declara ao Claude se só lê, se grava ou se altera o que já existe; o Claude pode usar essa informação para decidir quando pedir a sua confirmação. As que gravam estão marcadas com ✎ (grava). Algumas áreas — Ops, Pulse e Voice — existem só em organizações, e o resumo do dia e as perguntas ao Brain consomem consultas de IA do seu plano.

ÁreaO que cobreFerramentas
PlanBoard de tarefas: suas tarefas, busca, projetos e colunas; criar, alterar, mover e comentar tasks.plan_my_tasks, plan_search_tasks, plan_tree, plan_list_projects, plan_list_spaces, plan_list_statuses, plan_resolve_ref, plan_create_task ✎, plan_update_task ✎, plan_move_task ✎, plan_comment_task ✎
ObjetivosÉpicas com o progresso real, os passos, as dependências e a execução.goal_listar, goal_detalhe, goal_dependencias, goal_timeline
BrainMemória da organização: perguntar, buscar, visão do sistema; gravar fatos e decisões (ADR).brain_ask, brain_search, brain_system_understanding, brain_remember ✎, brain_record_decision ✎
DocsDocumentação: buscar, listar coleções, criar e atualizar páginas.docs_search, docs_list_collections, docs_create_page ✎, docs_update_page ✎
TwinSimulação: impacto de uma mudança, cenários, estimativas, previsão de sprint e arquitetura. Cada simulação (e o plano de uma meta) fica gravada no histórico do Twin.twin_impact_analysis ✎, twin_simulate_scenario ✎, twin_estimate ✎, twin_plan_goal ✎, twin_simulate_goal ✎, twin_simulations, twin_recommendations, twin_insights, twin_forecast, twin_architecture
Ops · PulseOperação: o que está no ar, incidentes, estado dos serviços e saúde medida depois de cada deploy.ops_deploys, ops_incidents, ops_saude_dos_servicos, pulse_saude_pos_deploy
Vivo · VoiceReuniões do período e requisitos extraídos de conversas com clientes.vivo_meetings_overview, voice_requirements
GitHubLeitura de pull requests: estado, diff, CI, comentários e o passo do job que falhou. Só leitura.github_pr, github_pr_diff, github_pr_checks, github_pr_comments, github_ci_detalhe
SuíteQuem é você na suíte e um resumo do seu trabalho («o que tenho para hoje?»).suite_context, suite_briefing

O conector não faz merge, não apaga branch, não abre nem comenta pull request e não muda configurações da organização.

Exemplos de uso

Planejar o dia

Prompt: «O que tenho para hoje no Orkestra, e qual é a minha tarefa de maior prioridade?»

Pré-requisito: Uma conta Orkestra com tarefas atribuídas a você no Plan.

Avaliar o impacto de uma mudança

Prompt: «Qual o impacto de trocar o serviço de autenticação por outro provedor? Quais componentes e riscos?»

Pré-requisito: Um workspace com o modelo do sistema no Twin e no Brain (componentes e dependências registrados). A análise fica gravada no histórico de simulações do Twin.

Registrar trabalho no board

Prompt: «Crie uma task no projeto Demo para corrigir o timeout do login e comente nela o passo a passo para reproduzir.»

Pré-requisito: Um projeto no Plan em que a sua conta possa escrever.

Dados e privacidade

  • O conector lê e grava somente o que a sua conta alcança no contexto escolhido (pessoal ou organização).
  • Para tirar o acesso do Claude, desconecte o conector nas configurações do Claude.
  • As leituras do GitHub usam a credencial de GitHub que você cadastrou no Orkestra, quando houver.
  • Política de privacidade: orkestraai.com.br/legal/privacy · Termos: orkestraai.com.br/legal/terms

Suporte

Dúvidas, problemas de acesso ou pedidos: contato@orkestraai.com.br. Questões de segurança: security@orkestraai.com.br.