Adios.dev

Servidor MCP oficial do Adios e plugin Codex para construir, visualizar, implantar e operar projetos a partir de ferramentas de IA.

Documentação

Adios MCP

Use os workspaces, previews, builds, logs e deploys do Adios a partir do Codex, Claude Code, Gemini CLI, Kimi Code, GitHub Copilot, ChatGPT e outros clientes MCP.

Este repositório empacota o serviço hospedado Adios MCP para instalação pública. Ele inclui um pacote portátil Agent Plugins v1, plugins de marketplace para Codex e Claude Code, extensões nativas para Gemini CLI e Kimi Code, dois workflows reutilizáveis, exemplos de conexão e uma referência legível de ferramentas. O servidor roda no Adios, então os usuários não precisam implantar nada deste repositório.

Endpoints

FinalidadeURL
Streamable HTTP (preferido)https://api.adios.dev/v1/mcp
Fallback SSEhttps://api.adios.dev/v1/mcp/sse
Metadados públicos de conexãohttps://api.adios.dev/v1/mcp/config
Descoberta pública de ferramentashttps://api.adios.dev/v1/mcp/tools

As chamadas de ferramentas usam OAuth do Adios e são limitadas ao usuário e à equipe autenticados. Os metadados de conexão e os esquemas de ferramentas são públicos; é necessária uma conta Adios para agir em workspaces ou workloads.

Instalar no Codex

Registre o marketplace do GitHub:

codex plugin marketplace add adiosdotdev/mcp

Reinicie o aplicativo de desktop do ChatGPT, abra Plugins, escolha o marketplace Adios, instale Adios MCP e conclua o OAuth quando solicitado. O plugin instala a conexão MCP remota e ambas as skills de workflow.

Para conectar apenas o servidor MCP sem o plugin:

codex mcp add adios --url https://api.adios.dev/v1/mcp
codex mcp login adios

O equivalente config.toml está em examples/codex-config.toml.

Instalar no Claude Code

Registre o marketplace e instale o plugin:

claude plugin marketplace add adiosdotdev/mcp
claude plugin install adios-mcp@adios

Reinicie o Claude Code ou execute /reload-plugins, depois abra /mcp e conclua o OAuth para o servidor Adios. O plugin instala a conexão MCP e ambas as skills de workflow.

Instalar no Gemini CLI

Instale o repositório como uma extensão do Gemini CLI:

gemini extensions install https://github.com/adiosdotdev/mcp

Reinicie o Gemini CLI após a instalação. A extensão carrega o servidor MCP hospedado e ambas as skills de workflow. Se o login não iniciar automaticamente, execute /mcp auth adios no Gemini CLI e conclua o OAuth no navegador.

Instalar no Kimi Code

Instale o repositório pelo gerenciador de plugins do Kimi Code:

/plugins install https://github.com/adiosdotdev/mcp
/reload
/mcp-config login adios

Conclua o OAuth no navegador após o comando de login. O plugin conecta o Kimi Code, incluindo sessões Kimi K3, ao servidor MCP hospedado e carrega ambas as skills de workflow.

Instalar como um Agent Plugin portátil

Clientes que implementam Agent Plugins v1 descobrem automaticamente a raiz plugin.json, mcp.json e skills/. Por exemplo, instale o repositório no GitHub Copilot CLI com:

copilot plugins install adiosdotdev/mcp

O pacote portátil inicia npx -y @adiosdotdev/mcp, que faz a ponte entre stdio e o endpoint hospedado e conclui o OAuth do Adios quando o cliente se conecta.

Instalar apenas as skills

Peça ao Codex para instalar qualquer um dos caminhos do GitHub com $skill-installer:

Use $skill-installer to install https://github.com/adiosdotdev/mcp/tree/main/plugins/adios-mcp/skills/adios-build-deploy
Use $skill-installer to install https://github.com/adiosdotdev/mcp/tree/main/plugins/adios-mcp/skills/adios-operate-debug

Instalações apenas de skills não configuram o servidor MCP; adicione a conexão MCP adios separadamente.

Usar via npm

Para clientes MCP que iniciam um comando stdio local, use o pacote npm público.

Requer Node.js 20.18.1 ou posterior e npm.

{
  "mcpServers": {
    "adios": {
      "command": "npx",
      "args": ["-y", "@adiosdotdev/mcp"]
    }
  }
}

O comando inicia uma ponte local para o endpoint hospedado do Adios e abre o OAuth quando o cliente se conecta. Nada da plataforma Adios é executado localmente.

Outros clientes MCP

Crie uma conexão MCP remota ou Streamable HTTP chamada adios com esta URL:

https://api.adios.dev/v1/mcp

Deixe o cliente concluir o OAuth em vez de adicionar um token estático. Se o cliente não suportar Streamable HTTP, use o endpoint SSE mostrado acima. Os nomes dos campos de configuração variam conforme o cliente.

Workflows incluídos

  • adios-build-deploy: criar ou importar um workspace, atualizar o código-fonte, validar adios.yaml, executar lint/build, iniciar uma preview e fazer deploy após aprovação.
  • adios-operate-debug: inspecionar o estado de Git/runtime/comandos, analisar logs, diagnosticar falhas e realizar correções operacionais verificadas.

Consulte docs/tool-reference.md para os grupos de ferramentas atuais e operações sensíveis a aprovação. O endpoint /tools ao vivo continua sendo a fonte da verdade.

Para a listagem no diretório Glama, consulte docs/glama.md para configurações de build e configuração do conector hospedado.

Segurança

Deploys, alterações de workload, paradas de runtime, pushes Git remotos e exclusão de arquivos devem permanecer sensíveis a aprovação. Nunca faça commit de tokens OAuth do Adios, credenciais de aplicativos ou segredos de workspace neste repositório ou no código-fonte do projeto.

Estrutura do repositório

.agents/plugins/marketplace.json       Codex marketplace catalog
.claude-plugin/marketplace.json        Claude Code marketplace catalog
plugin.json                            Portable Agent Plugins v1 manifest
mcp.json                               Portable npm stdio bridge configuration
kimi.plugin.json                       Kimi Code plugin manifest
plugins/adios-mcp/.codex-plugin/       Codex plugin manifest
plugins/adios-mcp/.claude-plugin/      Claude Code plugin manifest
plugins/adios-mcp/.mcp.json            Hosted MCP connection
plugins/adios-mcp/skills/              Codex and Claude Code workflows
gemini-extension.json                  Gemini CLI extension manifest
GEMINI.md                              Gemini CLI extension context
skills/                                Portable, Gemini, and Kimi workflow copies
bin/adios-mcp.js                       npm stdio bridge command
docs/                                  Tool and operating reference
examples/                              Direct client configuration

Documentação da plataforma Adios: www.adios.dev/mcp

Licença

MIT