MCP server quickstart

This guide instructs you through your first question to the Azion MCP servers. The example uses Claude Code. It connects the docs server, which only reads, and then shows how to add the four servers that change your account.

• Create a personal token in Azion Console.
• Register the docs server in Claude Code with one command.
• Verify that Claude Code lists the server and its tools.
• Ask Claude Code a question that the server answers from the Azion documentation.

Every other client connects with the same server URL and token. Agent Setup has the steps for Cursor, GitHub Copilot, Windsurf, Codex, Gemini CLI, OpenCode, Claude Desktop, Warp, and Kiro.

Three pieces connect, in this order:

1. The personal token identifies your Azion account.
2. The server entry azion-docs in Claude Code points at https://docs-mcp.azion.com/mcp and sends the token in the Authorization header of every request.
3. The docs server checks the token and gives Claude Code its tools and resources.

For more information about the servers, refer to MCP server.

Prerequisites

• An Azion account. To create one, refer to Create an account.
• Claude Code, installed on your machine. To use another client, refer to Agent Setup.

Create a personal token

The servers accept an Azion personal token as their credential. To create the token in Azion Console:

The token appears in the Personal Tokens list, and its value is in your clipboard. For more information, refer to How to manage a personal token.

Keep the token safe:

• Never commit a token. Add every configuration file that holds one to .gitignore.
• Store the token in an environment variable when your client supports it.
• Rotate your tokens regularly.

Connect Claude Code

The claude mcp add command registers a server. The -t http flag selects the HTTP transport, -s user stores the server for every project, and -H sets the header that carries your token. Run the command, and replace [TOKEN VALUE] with your token:

Claude Code stores the server in your user configuration, which is not a file in your project. The personal token goes in the Token scheme. A personal token sent with the Bearer scheme fails with 401.

Claude Code has the docs server registered as azion-docs. To add another server, run the same command with its name and URL:

These four servers create, change, and delete resources in your account. Add only the ones the agent needs. For what each one covers, refer to Tools and resources. For more information about Claude Code with Azion, refer to Claude Code + Azion.

Verify the connection

The claude mcp list command checks every server that Claude Code has registered. Run it:

The azion-docs line shows the server URL, the HTTP transport, and ✔ Connected:

To see the tools, run /mcp inside a Claude Code session and select azion-docs. The docs server lists seven tools. For the full list, refer to Tools and resources.

A request without a token fails with 401, and a request with an invalid token fails with 403. To diagnose a failed connection, refer to Troubleshoot the MCP server.

Ask your first question

The search_azion_docs_and_site tool searches the Azion documentation and website. In a Claude Code session, ask a question that needs it:

The tool returns the documentation pages that best match the question, each with its title, content, and source URL. Claude Code builds its answer from these pages.

The other tools of the docs server return code samples, Azion CLI commands, Azion API operations, Terraform resources, and guides to deploy a static site. With the build and observe servers also connected, the agent can create rules and write GraphQL queries for your account. Try one of these prompts next:

• 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?

Claude Code answers questions about Azion from the docs server.

Connect another client

Claude Code is one client among many. Agent Setup has a page for each supported client, with its configuration, a prompt to verify the connection, and the fixes for its common errors. Each page connects the docs server, and the other servers connect the same way with their URLs:

Next steps