# Guia de Configuração MCP

import Code from '~/components/Code/Code.astro'

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](https://console.azion.com/personal-tokens)
   - 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

<Code lang="bash" code={`# 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:

<Code lang="json" code={`{
    "mcpServers": {
        "azion": {
            "type": "streamable-http",
            "url": "https://mcp.azion.com",
            "headers": {
                "Authorization": "Token SEU_PERSONAL_TOKEN"
            }
        }
    }
}`} />

:::note
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**:

<Code lang="json" code={`{
    "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:

<Code lang="json" code={`{
    "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:

<Code lang="json" code={`{
    "mcpServers": {
        "azion": {
            "type": "http",
            "url": "https://mcp.azion.com",
            "headers": {
                "Authorization": "Bearer SEU_PERSONAL_TOKEN"
            }
        }
    }
}`} />

:::warning
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:

<Code lang="json" code={`{
    "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`:

<Code lang="json" code={`{
    "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`:

<Code lang="toml" code={`[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

<Code lang="bash" code={`npm install -g @modelcontextprotocol/inspector`} />

#### Teste

1. Execute o inspector:
   <Code lang="bash" code={`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 uso | Ambiente | URL |
|-------------|----------|-----|
| Uso em produção | Produção | **https://mcp.azion.com** |
| Desenvolvimento | Local | **http://localhost:3333** |

:::note
Desenvolvimento local requer executar o servidor MCP localmente. Veja o [repositório GitHub](https://github.com/aziontech/mcp-server) 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

- [Explorar exemplos MCP](/pt-br/documentacao/devtools/mcp/exemplos/)
- [Guia de solução de problemas](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)
- [Desenvolvimento Local](/pt-br/documentacao/devtools/mcp/desenvolvimento-local/)
- [Guia de Teste de Cache](/pt-br/documentacao/devtools/mcp/teste-cache/)