O Orkestral gerencia servidores MCP por workspace. Troque de workspace e você troca quais servidores estão conectados. Todas as credenciais que você insere permanecem na sua máquina.
O que o MCP adiciona ao seu time
Novas ferramentas para os agentes
Cada servidor publica um conjunto de ferramentas. Controle de navegador, busca na web, acesso a banco de dados, APIs de arquivos e muito mais ficam disponíveis para chamada durante uma tarefa.
Controle por modelo
Você decide quais modelos recebem um servidor. Dê acesso ao navegador para o modelo do seu agente de QA e mantenha-o desligado nos demais.
Traga suas próprias credenciais
Servidores que precisam de uma chave de API pedem a chave na instalação. As chaves são armazenadas localmente e nunca saem da sua máquina.
Reaproveite configurações existentes
O Orkestral detecta servidores MCP que você já configurou no Claude Code, Codex, Gemini e Cursor para que você possa importá-los em um clique.
Abra a tela de MCPs
A tela de MCPs tem duas abas. Marketplace é onde você navega e instala servidores. Installed é onde você gerencia o que está conectado e importa servidores detectados nas suas outras CLIs.Escolha um workspace ativo
Abra o Orkestral e verifique se há um workspace selecionado. A tela de MCPs precisa de um workspace ativo, porque os servidores são conectados por workspace. Sem nenhum selecionado, a tela pede que você escolha um primeiro.
Instale um servidor pelo marketplace
A busca do marketplace acessa um registro ao vivo, então você pode encontrar servidores além dos destaques selecionados. O exemplo abaixo usa o Playwright, mas os passos são os mesmos para qualquer servidor.Busque pelo servidor
Na aba Marketplace, digite na caixa de busca no topo (por exemplo,
playwright). Os resultados são atualizados conforme você digita. Use os chips de categoria abaixo da caixa de busca para refinar a lista, ou navegue pelos destaques Featured quando a caixa estiver vazia.Abra os detalhes do servidor
Clique em um card para abrir seu diálogo de detalhes. Lá você vê a descrição, o autor, a categoria, a contagem de estrelas, links para o repositório e a homepage, e o README completo quando há um disponível.
Insira credenciais se solicitado
Se o servidor precisar de uma chave de API ou token, uma seção Credentials aparece com um campo por valor. Os campos obrigatórios precisam ser preenchidos antes de você poder instalar. Muitos servidores incluem um link Get credential que abre a página do provedor onde você gera a chave.
Escolha quais modelos podem usá-lo
Em Enable on models, escolha os modelos que recebem este servidor. O escopo padrão é todo modelo (
*). Restrinja a um modelo específico quando apenas uma parte do seu time precisar das ferramentas.Importe um servidor das suas CLIs
Se você já usa servidores MCP em outra ferramenta, não precisa configurá-los novamente. O Orkestral lê os arquivos de configuração conhecidos (apenas leitura) e lista o que encontra para que você importe com um clique.Quais CLIs são detectadas
Quais CLIs são detectadas
O Orkestral procura servidores configurados em:
- Claude Code:
~/.claude.json(servidores globais mais servidores por projeto) - Codex:
~/.codex/config.toml(as seções[mcp_servers.*]) - Gemini:
~/.gemini/settings.json - Cursor:
~/.cursor/mcp.json
O que é importado
O que é importado
Ambos os estilos de transporte são reconhecidos: servidores baseados em comando (
stdio, com seus command, args e env) e servidores baseados em URL (http ou sse, com sua url e headers). O servidor importado mantém o mesmo nome que tinha na CLI de origem.Encontre a seção Detected in CLIs
Abaixo dos servidores gerenciados pelo Orkestral, uma seção Detected in CLIs lista todos os servidores encontrados nas suas outras ferramentas. Cada linha mostra o nome do servidor, um selo da CLI de origem e o comando ou a URL que ele executa.
Gerencie um servidor conectado
Tudo o que você instala ou importa aparece em Managed by Orkestral na aba Installed. Cada linha mostra o escopo de modelos e se as credenciais estão definidas.Abra o servidor
Clique na linha de um servidor para abrir seu diálogo de detalhes com uma ação Manage.
Atualize credenciais ou escopo
Altere valores de credenciais ou ajuste em quais modelos o servidor roda, depois clique em Save changes. As credenciais existentes exibem um placeholder mascarado, então você pode deixar um campo intocado para manter o valor atual.
O selo numérico na aba Installed conta apenas os servidores gerenciados pelo Orkestral no workspace ativo, não os detectados nas suas CLIs.
Dicas e solução de problemas
Um servidor que configurei em uma CLI não é detectado
Um servidor que configurei em uma CLI não é detectado
Confirme que o arquivo de configuração existe no caminho esperado e usa o formato
mcpServers (ou [mcp_servers.*] no caso do Codex). A detecção ignora entradas que não têm nem um command nem uma url. Reabra a aba Installed para atualizar a lista.Meus agentes não estão usando as ferramentas do servidor
Meus agentes não estão usando as ferramentas do servidor
Verifique o escopo de modelos. Um servidor só alcança os modelos para os quais você o habilitou. Abra o servidor, confirme que os modelos certos estão selecionados em Enable on models e salve.
Onde minhas credenciais ficam armazenadas
Onde minhas credenciais ficam armazenadas
As credenciais que você insere são mantidas localmente junto com o servidor conectado, nos dados do seu workspace. Elas não são enviadas para nenhum lugar exceto para o servidor para o qual você as conectou.
O que fazer em seguida
Adicione uma skill
Combine ferramentas MCP com skills reutilizáveis que ensinam seus agentes como e quando usá-las.
Contrate seu time
Traga os especialistas que vão colocar essas ferramentas para trabalhar na sua base de código.