Deployment.io

Configuração MCP para Agentes de Codificação com IA

---

O Model Context Protocol (MCP) permite que agentes de codificação com IA interajam com sua infraestrutura deployment.io. Uma vez configurados, agentes como Claude Code, Cursor, OpenAI Codex, Gemini CLI e Antigravity podem implantar seus aplicativos, gerenciar ambientes, buscar logs de execução e monitorar builds — diretamente do seu fluxo de trabalho de desenvolvimento.

Pré-requisitos

• Uma conta deployment.io

Métodos de Conexão

Existem duas maneiras de conectar seu agente de codificação ao deployment.io:

1. OAuth (recomendado) — O agente abre uma janela do navegador, você faz login e aprova o acesso. Não é necessário copiar chaves manualmente.
2. Chave de API — Gere uma chave no painel e cole-a na configuração do seu agente.

---

Método 1: OAuth (Recomendado)

O OAuth permite conectar com um único clique — sem chave de API para copiar ou gerenciar.

Claude Code CLI

Execute o seguinte comando:

claude mcp add --transport http Deployment-io https://api.deployment.io/v1/mcp

O Claude Code abrirá uma janela do navegador onde você faz login no deployment.io e aprova o acesso. A conexão é estabelecida automaticamente.

Claude Desktop

1. Vá para Personalizar > Conectores > + > Adicionar conector personalizado.
2. Insira o nome Deployment-io e a URL: https://api.deployment.io/v1/mcp
3. O Claude Desktop abrirá um navegador para você fazer login e aprovar o acesso.

Cursor

1. Abra o Cursor e vá para Configurações > Ferramentas e MCP.
2. Clique em Adicionar MCP personalizado.
3. Insira a URL: https://api.deployment.io/v1/mcp
4. O Cursor abrirá um navegador para você fazer login e aprovar o acesso.

OpenAI Codex

1. Adicione o servidor ao seu ~/.codex/config.toml:

[mcp_servers.Deployment-io]
url = "https://api.deployment.io/v1/mcp"

2. Execute o comando de login OAuth:

codex mcp login Deployment-io

O Codex abrirá uma janela do navegador onde você faz login no deployment.io e aprova o acesso.

Antigravity

1. Abra o Menu no painel do Agente e vá para Servidores MCP > Gerenciar servidores MCP.
2. Clique em Ver configuração bruta para abrir mcp_config.json.
3. Adicione a seguinte configuração:

{
  "mcpServers": {
    "Deployment-io": {
      "serverUrl": "https://api.deployment.io/v1/mcp"
    }
  }
}

4. Clique em Atualizar. O Antigravity abrirá um navegador para você fazer login e aprovar o acesso.

---

Método 2: Chave de API

Se o seu agente não suporta OAuth, ou se você prefere configuração manual, use uma chave de API.

Etapa 1: Gerar uma Chave de API

1. Vá para Configurações da Organização > Chaves de Agente no seu painel deployment.io.
2. Clique em Criar Nova Chave e dê a ela um nome descritivo (por exemplo, "Chave do Claude Code").
3. Copie a chave de API imediatamente — você não poderá vê-la novamente.

Etapa 2: Copiar a Configuração MCP

Após gerar sua chave, você verá um bloco de configuração JSON MCP como este:

{
  "mcpServers": {
    "Deployment-io": {
      "url": "https://api.deployment.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Substitua YOUR_API_KEY pela chave que você copiou na Etapa 1.

Configuração do Agente com Chave de API

Claude Code CLI

claude mcp add --transport http Deployment-io https://api.deployment.io/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Adicione a configuração ao seu arquivo claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Mescle a configuração JSON MCP da Etapa 2 no arquivo.

Cursor

1. Abra o Cursor e vá para Configurações > Ferramentas e MCP.
2. Clique em Adicionar MCP personalizado.
3. Cole a configuração JSON MCP da Etapa 2 no editor.
4. Salve e reinicie o Cursor.

Windsurf

1. Abra o Windsurf e vá para Configurações > MCP.
2. Clique em Adicionar Servidor e selecione HTTP.
3. Cole a configuração JSON MCP da Etapa 2.
4. Salve e reinicie o Windsurf.

OpenAI Codex

Adicione o servidor ao seu ~/.codex/config.toml:

[mcp_servers.Deployment-io]
url = "https://api.deployment.io/v1/mcp"
bearer_token_env_var = "DEPLOYMENT_IO_API_KEY"

Em seguida, defina a variável de ambiente:

export DEPLOYMENT_IO_API_KEY=YOUR_API_KEY

Gemini CLI

Execute o seguinte comando:

gemini mcp add -s user --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  Deployment-io https://api.deployment.io/v1/mcp

Ou adicione manualmente ao seu ~/.gemini/settings.json:

{
  "mcpServers": {
    "Deployment-io": {
      "httpUrl": "https://api.deployment.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity

1. Abra o Menu no painel do Agente e vá para Servidores MCP > Gerenciar servidores MCP.
2. Clique em Ver configuração bruta para abrir mcp_config.json.
3. Adicione a seguinte configuração:

{
  "mcpServers": {
    "Deployment-io": {
      "serverUrl": "https://api.deployment.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

4. Clique em Atualizar e reinicie o Antigravity.

---

Solução de Problemas

• Verifique se sua conexão funciona: Execute um prompt simples como "liste meus ambientes" no seu agente. Se a conexão estiver funcionando, você verá seus ambientes listados.
• Verifique a URL MCP: Certifique-se de que a URL seja exatamente https://api.deployment.io/v1/mcp sem barra final.
• Problemas com OAuth: Se a janela de autorização do navegador não abrir, verifique se o seu agente suporta conexões MCP baseadas em OAuth. Use o método de chave de API como alternativa, se necessário.
• Regenere a chave: Se sua chave de API parar de funcionar, ela pode ter sido revogada. Crie uma nova na página de configurações de Chaves de Agente.
• Revogue o acesso: Você pode revogar agentes conectados via OAuth ou chaves de API a qualquer momento em Configurações da Organização > Chaves de Agente.