Guia de Configuração MCP

Instruções passo a passo para configurar a integração do Model Context Protocol (MCP) com vários assistentes de código e ferramentas de desenvolvimento.

Ver como Markdown

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 server

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"
}
}
}
}

O Cursor usa o prefixo Token em vez de Bearer no header de autorização.

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"
}
}
}
}

O suporte MCP no VS Code pode requerer extensões adicionais. Verifique o marketplace por extensões compatíveis com MCP.

Warp Terminal

Configure o MCP nas configurações do Warp.

Configuração

Adicione às configurações MCP do Warp:

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

Kiro Code

O Kiro Code suporta MCP através de seu arquivo de configurações.

Configuração

Crie .kiro/settings/mcp.json:

{
"servers": {
"azion": {
"url": "https://mcp.azion.com",
"token": "SEU_PERSONAL_TOKEN"
}
}
}

OpenCode

O OpenCode usa configuração TOML para servidores MCP.

Configuração

Crie .codex/config.toml:

[mcp.servers.azion]
type = "http"
url = "https://mcp.azion.com"
auth = "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:

Caso de usoAmbienteURL
Uso em produçãoProduçãohttps://mcp.azion.com
DesenvolvimentoLocalhttp://localhost:3333

Desenvolvimento local requer executar o servidor MCP localmente. Veja o repositório GitHub para instruções de configuração.

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