@madeinvibecoding/opensquad

MCP Server para o framework opensquad — use squads de agentes de IA em qualquer ferramenta MCP-compativel.

O que e este pacote?

Este pacote e um MCP Server (Model Context Protocol) construido sobre o opensquad, o framework open source de orquestracao multi-agente criado por Renato Asse.

O opensquad original funciona via slash commands dentro do Claude Code. Este MCP server expoe as funcionalidades do framework como tools MCP, permitindo que qualquer ferramenta compativel consiga listar, gerenciar e consultar squads, skills e agentes — sem depender do Claude Code.

Ferramentas compativeis

• Qwen Code
• Gemini CLI
• Cursor
• VS Code + Copilot
• Windsurf
• Claude Desktop
• Qualquer cliente que suporte o protocolo MCP via stdio

Instalacao e Configuracao

Pre-requisito: Node.js >= 20

1. Inicialize um projeto opensquad

npx @madeinvibecoding/opensquad init

2. Configure o MCP na sua ferramenta

Adicione ao arquivo de configuracao MCP da sua ferramenta:

{
  "mcpServers": {
    "opensquad": {
      "command": "npx",
      "args": ["@madeinvibecoding/opensquad", "mcp"],
      "env": {
        "OPENSQUAD_PROJECT_DIR": "/caminho/absoluto/do/seu/projeto"
      }
    }
  }
}

Onde colocar o JSON

| Ferramenta | Arquivo | |------------|---------| | Claude Code / Claude Desktop | .mcp.json na raiz do projeto | | Cursor | .cursor/mcp.json | | VS Code + Copilot | .vscode/mcp.json | | Windsurf | ~/.windsurf/mcp.json | | Qwen Code | Settings > MCP Servers | | Gemini CLI | ~/.gemini/settings.json |

Pronto. A ferramenta vai conectar automaticamente e as 12 tools estarao disponiveis.

Tools Disponiveis (12)

Consulta

| Tool | O que faz | |------|-----------| | get_project_status | Status geral do projeto (versao, contagens) | | list_squads | Lista todos os squads com status | | get_squad_detail | Detalhes completos de um squad | | list_runs | Historico de execucoes | | list_skills | Skills instaladas no projeto | | list_available_skills | Catalogo de skills disponiveis | | list_agents | Agentes instalados no projeto | | list_available_agents | Catalogo de agentes disponiveis |

Acoes

| Tool | O que faz | |------|-----------| | install_skill | Instala uma skill do catalogo | | uninstall_skill | Remove uma skill instalada | | install_agent | Instala um agente do catalogo | | uninstall_agent | Remove um agente instalado |

Exemplos de Uso

Depois de configurar, basta pedir ao LLM da sua ferramenta:

• "Qual o status do meu projeto opensquad?"
• "Quais squads eu tenho?"
• "Me mostra os detalhes do squad carrossel-news"
• "Quais skills posso instalar?"
• "Instala a skill resend"
• "Mostra o historico de execucoes"

O LLM vai chamar as tools MCP automaticamente.

Publicando nas redes sociais

Este projeto inclui skills para publicar conteudo gerado pelos squads diretamente em redes sociais. Hoje o Instagram esta coberto com duas opcoes complementares. Outras plataformas (LinkedIn, X/Twitter, Facebook) seguem o mesmo padrao e serao adicionadas em fases futuras como skills separadas por plataforma.

Instagram

Duas skills disponiveis, escolha conforme o tipo da sua conta:

| Skill | Tipo de conta | Setup | Preview visual | |-------|---------------|-------|----------------| | instagram-publisher (Graph API) | Business ou Creator apenas | Facebook Developer App + token + imgBB API key | Nao | | instagram-publisher-browser (browser automation) | Qualquer conta (inclusive pessoal) | Login manual unico via Chrome real | Sim (pausa antes de publicar) |

Para comecar com a opcao browser: siga o QUICKSTART-INSTAGRAM-BROWSER.md. Tem o passo a passo completo: pre-requisitos, clone, setup de login uma vez por maquina, preparo das imagens, e como pedir ao Claude para publicar.

Roadmap de outras plataformas

Skills planejadas seguindo o mesmo padrao ({plataforma}-publisher-browser):

• LinkedIn — posts, artigos, e galerias de imagens
• X/Twitter — tweets unicos e threads
• Facebook — posts e carrosseis em paginas

Cada plataforma recebe sua propria skill (DOM e convencoes variam demais para generalizar). O instagram-publisher-browser e a referencia de padrao — estrutura de 12 steps, checkpoints duplos, perfil Playwright persistente, tabelas de selectors com fallbacks por locale, setup de login por plataforma.

O que o opensquad faz?

O opensquad e um framework que cria squads de agentes de IA que trabalham juntos. Cada squad e uma equipe com papeis definidos (pesquisador, redator, designer, revisor) que executa em pipeline com checkpoints de aprovacao humana.

Casos de uso:

• Producao de conteudo para redes sociais (carrosseis, posts, artigos)
• Campanhas de marketing e lancamentos
• Analise de dados e relatorios
• Tutoriais com screenshots automaticos
• Cortes de video automaticos
• E muito mais

Para saber mais sobre o framework completo, visite o repositorio original.

Criar e executar squads via MCP

Embora o MCP server tenha sido projetado inicialmente apenas para consulta e gerenciamento, na pratica LLMs como Qwen Code conseguem criar e executar squads completos usando as tools MCP para entender a estrutura do projeto e replicar o formato dos squads existentes.

Testado e funcionando no Qwen Code: criacao de squad com 5 agentes, pipeline de 13 steps com checkpoints de aprovacao humana, propostas visuais e execucao completa.

Limitacoes atuais

• Transporte HTTP — o server usa stdio (suficiente para clientes locais). HTTP pode vir em v2

Creditos

Projeto opensquad

Criado e mantido por Renato Asse, fundador da Comunidade Sem Codar — Escola de IA com mais de 25 mil alunos.

Repositorio original: github.com/renatoasse/opensquad

MCP Server

Desenvolvido por Giovani Junior (@madeinvibecoding) para tornar o opensquad acessivel em qualquer ferramenta MCP-compativel, como Qwen Code, Gemini CLI, Cursor e VS Code.

Licenca

MIT — use como quiser.