Orquestra · 2026-07-12

Plugins MCP no Orquestra: Estendendo as Capacidades

Guia completo para usar plugins MCP no Orquestra. Conecte seus agentes de IA a bancos de dados, APIs, sistemas de arquivos e ferramentas customizadas no Windows 11.

O MCP (Model Context Protocol) e um dos avancos mais importantes para o ecossistema de agentes de IA em 2026. Criado pela Anthropic, ele padroniza a forma como agentes de IA interagem com ferramentas externas. No Orquestra, o suporte a MCP e nativo e extensivel, permitindo que voce conecte seus agentes a praticamente qualquer servico com poucos cliques.

O que e o MCP e por que ele importa?

Antes do MCP, cada agente de IA tinha sua propria forma de interagir com ferramentas externas. Claude Code usava integracoes proprietarias, Codex CLI tinha suas proprias extensoes, e OpenCode dependia de scripts manuais. Isso criava um ecossistema fragmentado onde uma configuracao que funcionava em um agente nao funcionava em outro.

O MCP resolve isso padronizando a comunicacao. Pense nele como um "USB para agentes de IA": qualquer servidor MCP funciona com qualquer agente que suporte o protocolo. No Orquestra, voce configura o servidor MCP uma vez e todos os seus agentes (Claude Code, Codex, OpenCode) podem usa-lo.

Exemplo: Com um servidor MCP PostgreSQL, tanto Claude Code quanto Codex podem fazer consultas ao banco de dados -- sem configuracao adicional para cada agente.

Catalogo de servidores MCP disponiveis

O Orquestra oferece um catalogo integrado de servidores MCP que podem ser instalados com um clique. Os mais populares incluem:

  • Filesystem: Acesso controlado ao sistema de arquivos local. Permite que agentes leiam, escrevam e organizem arquivos dentro de diretorios autorizados.
  • PostgreSQL / SQLite: Conexao direta a bancos de dados para consultas, migracoes e analise de dados pelos agentes.
  • GitHub / GitLab: Gerenciamento de repositorios, issues e pull requests diretamente pelos agentes.
  • Puppeteer / Playwright: Automacao de navegador para testes e2e e raspagem de dados.
  • Brave Search / Web: Busca na web integrada para agentes pesquisarem documentacao e exemplos.
  • Docker: Gerenciamento de containers Docker para ambientes de desenvolvimento isolados.

Instalando e configurando servidores MCP

Existem duas formas de configurar servidores MCP no Orquestra:

Via catalogo integrado (recomendado)

A forma mais simples: va em "Configuracoes" > "MCP" >"Catalogo", encontre o servidor desejado e clique em "Instalar". O Orquestra baixa, configura e ativa o servidor automaticamente.

Via arquivo de configuracao manual

Para servidores customizados ou auto-hospedados, edite o arquivo de configuracao MCP do workspace:

// .orquestra/mcp-servers.json { "servers": { "meu-banco": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/mydb" ] }, "arquivos": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "./projeto" ] } } }

Apos configurar, os servidores aparecem no painel MCP do Orquestra com o status "Conectado" ou "Erro". Todos os agentes no workspace passam a ter acesso as ferramentas expostas pelos servidores.

Usando ferramentas MCP nos agentes

Uma vez configurado, usar as ferramentas MCP e transparente para os agentes. Quando voce faz um pedido ao Claude Code como "leia o arquivo package.json e me mostre as dependencias", o agente pode usar a ferramenta filesystem_read do servidor MCP de arquivos automaticamente.

Voce tambem pode chamar ferramentas MCP explicitamente:

# No terminal do Claude Code use_tool meu-banco query "SELECT * FROM users LIMIT 5;" # Resultado: lista de usuarios retornada diretamente no chat use_tool arquivos list "src/components" # Resultado: listagem de arquivos no diretorio

O Orquestra mostra um indicador no terminal quando um agente esta usando uma ferramenta MCP, incluindo qual servidor esta sendo acessado e qual funcao esta sendo chamada. Isso da visibilidade total sobre o que os agentes estao fazendo.

Criando seus proprios servidores MCP

Se o catalogo de servidores MCP nao atender sua necessidade, voce pode criar seus proprios servidores. O MCP e um protocolo simples baseado em JSON-RPC:

// Exemplo minimo de servidor MCP em Node.js import { Server } from '@modelcontextprotocol/sdk/server/index.js'; import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'; const server = new Server({ name: 'meu-servidor', version: '1.0.0', }, { capabilities: { tools: {} } }); server.setRequestHandler('tools/list', async () => ({ tools: [{ name: 'saudacao', description: 'Retorna uma saudacao personalizada', inputSchema: { type: 'object', properties: { nome: { type: 'string' } } } }] })); server.setRequestHandler('tools/call', async (req) => { if (req.params.name === 'saudacao') { return { content: [{ type: 'text', text: 'Ola, ' + req.params.arguments.nome }] }; } }); const transport = new StdioServerTransport(); await server.connect(transport);

Apos criar seu servidor, adicione-o ao arquivo de configuracao MCP do workspace e ele estara disponivel para todos os agentes.

Dica:O Orquestra inclui um template "Meu Primeiro Servidor MCP" no menu de exemplos. Use-o como ponto de partida para suas integracoes customizadas.

Seguranca e permissoes MCP

O Orquestra adiciona uma camada de seguranca sobre o protocolo MCP. Para cada servidor, voce pode configurar:

  • Permissoes por agente: Permita que Claude Code use o servidor de banco de dados, mas nao o servidor de arquivos.
  • Limites de uso: Defina quotas de chamadas por minuto para evitar uso excessivo de recursos.
  • Confirmacao manual: Exija aprovacao humana para operacoes destrutivas (DELETE, DROP, etc).
  • Auditoria: Todas as chamadas MCP sao registradas em um log de auditoria acessivel no painel de seguranca.

Expanda os limites dos seus agentes

Baixe o Orquestra gratis por 7 dias e explore o poder dos plugins MCP no Windows 11.