Guia de Configuração MCP

Este guia fornece instruções de configuração para integrar o servidor MCP da Azion com assistentes de código populares.

Pré-requisitos

Antes de configurar o MCP, certifique-se de ter:

1. Um Personal Token Azion

   • Navegue até o Console Azion
   • Crie um novo Personal Token
   • Copie e armazene com segurança

2. Um assistente de código compatível instalado

Claude Code (Terminal)

O Claude Code fornece suporte nativo ao MCP através de comandos CLI simples.

Instalação

# Adicionar MCP Azion ao Claude
claude mcp add "azion-mcp" "https://mcp.azion.com" -t http -H "Authorization: Bearer SEU_PERSONAL_TOKEN"

# Iniciar serviço Claude
claude serve

Uso

Uma vez configurado, você pode pedir ao Claude para:

• Buscar documentação da Azion
• Gerar guias de deploy
• Criar configurações do Rules Engine
• Construir queries GraphQL

Cursor

O Cursor suporta MCP através de sua interface de configurações.

Passos de configuração

1. Abra as Configurações do Cursor
2. Navegue até Tools & Integrations
3. Adicione a seguinte configuração MCP:

{
  "mcpServers": {
      "azion": {
          "type": "streamable-http",
          "url": "https://mcp.azion.com",
          "headers": {
              "Authorization": "Token SEU_PERSONAL_TOKEN"
          }
      }
  }
}

Windsurf

O Windsurf requer a criação de um arquivo de configuração em seu projeto.

Configuração

Crie o arquivo .codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
      "azion": {
          "command": "npx",
          "args": [
              "mcp-remote",
              "https://mcp.azion.com",
              "--header",
              "Authorization: Bearer SEU_PERSONAL_TOKEN"
          ]
      }
  }
}

Requisitos

• Node.js 18+ instalado
• Pacote mcp-remote (instalado automaticamente via npx)

Claude Desktop

O Claude Desktop suporta MCP através de suas configurações.

Configuração

1. Abra as configurações do Claude Desktop
2. Navegue até a configuração MCP
3. Adicione o seguinte:

{
  "mcpServers": {
      "azion": {
          "command": "npx",
          "args": [
              "mcp-remote",
              "https://mcp.azion.com",
              "--header",
              "Authorization: Bearer SEU_PERSONAL_TOKEN"
          ]
      }
  }
}

VS Code com GitHub Copilot

Para usuários do VS Code com extensão GitHub Copilot suportando MCP.

Configuração

Crie .vscode/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
      "azion": {
          "type": "http",
          "url": "https://mcp.azion.com",
          "headers": {
              "Authorization": "Bearer SEU_PERSONAL_TOKEN"
          }
      }
  }
}

Testando sua conexão

Usando o MCP Inspector

O MCP Inspector ajuda a validar sua configuração antes de usar com assistentes de código.

Instalação

npm install -g @modelcontextprotocol/inspector

Teste

1. Execute o inspector:

   npx @modelcontextprotocol/inspector

2. Configure a conexão:

   • Tipo de transporte: streamable-http
   • URL: https://mcp.azion.com
   • Autenticação: Authorization: Bearer SEU_PERSONAL_TOKEN

3. Clique em Connect

4. Verifique:

   • Aba Tools: Deve mostrar 9 ferramentas disponíveis
   • Aba Resources: Deve mostrar recursos de deploy

Testar uma ferramenta

1. Selecione search_azion_docs_and_site
2. Digite a query: "como configurar cache"
3. Verifique se a resposta contém documentação relevante

Seleção de ambiente

Escolha o ambiente apropriado baseado em suas necessidades:

Boas práticas de segurança

1. Nunca commitar tokens: Adicione arquivos de configuração ao .gitignore
2. Use variáveis de ambiente: Armazene tokens em variáveis de ambiente quando possível
3. Rotacione tokens regularmente: Crie novos tokens periodicamente
4. Use permissões mínimas: Crie tokens apenas com permissões necessárias
5. Tokens diferentes por ambiente: Use tokens separados para produção e desenvolvimento

Próximos passos

• Explorar exemplos MCP
• Guia de solução de problemas
• Suporte a perfil de API