Primeiros passos com o MCP server

Este guia orienta você na sua primeira pergunta aos MCP servers da Azion. O exemplo usa o Claude Code. Ele conecta o servidor de docs, que apenas lê, e depois mostra como adicionar os quatro servidores que alteram a sua conta.

• Crie um personal token no Azion Console.
• Registre o servidor de docs no Claude Code com um comando.
• Verifique se o Claude Code lista o servidor e as ferramentas dele.
• Faça ao Claude Code uma pergunta que o servidor responde a partir da documentação da Azion.

Todos os outros clientes se conectam com a mesma URL de servidor e o mesmo token. A Configuração de agentes tem os passos para Cursor, GitHub Copilot, Windsurf, Codex, Gemini CLI, OpenCode, Claude Desktop, Warp e Kiro.

Três peças se conectam, nesta ordem:

1. O personal token identifica a sua conta Azion.
2. A entrada do servidor azion-docs no Claude Code aponta para https://docs-mcp.azion.com/mcp e envia o token no header Authorization de cada requisição.
3. O servidor de docs verifica o token e entrega ao Claude Code as ferramentas e os recursos dele.

Para mais informações sobre os servidores, consulte MCP server.

Pré-requisitos

• Uma conta Azion. Para criar uma, consulte Criar uma conta.
• O Claude Code, instalado na sua máquina. Para usar outro cliente, consulte Configuração de agentes.

Crie um personal token

Os servidores aceitam um personal token da Azion como credencial. Para criar o token no Azion Console:

O token aparece na lista Personal Tokens, e o valor dele está na sua área de transferência. Para mais informações, consulte Como criar um personal token.

Mantenha o token seguro:

• Nunca faça commit de um token. Adicione ao .gitignore todo arquivo de configuração que contenha um.
• Guarde o token em uma variável de ambiente quando o seu cliente oferecer suporte a isso.
• Faça a rotação dos seus tokens regularmente.

Conecte o Claude Code

O comando claude mcp add registra um servidor. A flag -t http seleciona o transporte HTTP, -s user guarda o servidor para todos os projetos, e -H define o header que carrega o seu token. Execute o comando e substitua [TOKEN VALUE] pelo seu token:

O Claude Code guarda o servidor na sua configuração de usuário, que não é um arquivo do seu projeto. O personal token vai no esquema Token. Um personal token enviado com o esquema Bearer falha com 401.

O Claude Code tem o servidor de docs registrado como azion-docs. Para adicionar outro servidor, execute o mesmo comando com o nome e a URL dele:

Esses quatro servidores criam, alteram e excluem recursos na sua conta. Adicione apenas os de que o agente precisa. Para o que cada um cobre, consulte Ferramentas e recursos. Para mais informações sobre o Claude Code com a Azion, consulte Claude Code + Azion.

Verifique a conexão

O comando claude mcp list verifica cada servidor que o Claude Code tem registrado. Execute-o:

A linha azion-docs mostra a URL do servidor, o transporte HTTP e ✔ Connected:

Para ver as ferramentas, execute /mcp dentro de uma sessão do Claude Code e selecione azion-docs. O servidor de docs lista sete ferramentas. Para a lista completa, consulte Ferramentas e recursos.

Uma requisição sem token falha com 401, e uma requisição com um token inválido falha com 403. Para diagnosticar uma conexão que falhou, consulte Solucionar problemas do MCP server.

Faça sua primeira pergunta

A ferramenta search_azion_docs_and_site pesquisa na documentação e no site da Azion. Em uma sessão do Claude Code, faça uma pergunta que precise dela:

A ferramenta retorna as páginas da documentação que melhor correspondem à pergunta, cada uma com o título, o conteúdo e a URL de origem. O Claude Code monta a resposta a partir dessas páginas.

As outras ferramentas do servidor de docs retornam exemplos de código, comandos da Azion CLI, operações da Azion API, recursos do Terraform e guias para fazer o deploy de um site estático. Com os servidores de build e observe também conectados, o agente pode criar regras e escrever queries GraphQL para a sua conta. Experimente um destes prompts em seguida:

• I have a static website with HTML, CSS, and JavaScript files. Help me deploy it to Azion.
• Generate a query to analyze cache hit rates for my images.
• Create Rules Engine rules to add security headers including HSTS, X-Frame-Options, and CSP for my application. Preview them with dry_run first.
• My deployment is failing with error 503. How can I debug this?

O Claude Code responde a perguntas sobre a Azion a partir do servidor de docs.

Conecte outro cliente

O Claude Code é um cliente entre muitos. A Configuração de agentes tem uma página para cada cliente compatível, com a configuração dele, um prompt para verificar a conexão e as correções dos erros comuns. Cada página conecta o servidor de docs, e os outros servidores se conectam da mesma forma com as URLs deles:

Próximos passos