> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/programadores/getting-started.md).

# Primeiros passos

Instruções de configuração para assistentes de IA usando MCP

Ligue o seu assistente de IA à AirOps usando o servidor MCP. Este guia cobre a configuração para Codex, Claude Code, Cursor, VS Code, Windsurf e outros clientes MCP.

{% hint style="info" %}
**Claude Web ou Desktop?** Use a funcionalidade [Conector Claude](/docs/pt/programadores/claude-connector.md) para configuração com um clique e Apps Interativas.
{% endhint %}

**URL do servidor:** `https://app.airops.com/mcp`

As ferramentas de recursos exigem um espaço de trabalho AirOps pago, incluindo avaliações elegíveis dos planos pagos. Os espaços de trabalho gratuitos podem conectar e listar espaços de trabalho, mas não podem consultar nem alterar os dados do espaço de trabalho através do MCP. Consulte [acesso ao plano](/docs/pt/programadores/tools.md#plan-access).

A autenticação usa OAuth 2.0 — inicie sessão com a sua conta AirOps através do seu navegador.

## Codex

Use a funcionalidade [plugin MCP da AirOps](/docs/pt/programadores/codex-plugin.md) para configuração com um clique no Codex.

## Claude Code

Execute no seu terminal:

```bash
claude mcp add --transport http airops https://app.airops.com/mcp
```

Depois autentique-se:

1. Executar `/mcp` no Claude Code
2. Selecione o servidor AirOps
3. Escolha **Autenticar**
4. Conclua a sessão no seu navegador

## Cursor

1. Abrir **Definições do Cursor → Ferramentas & MCP → Novo servidor MCP**
2. Adicione a configuração:

```json
{
  "mcpServers": {
    "airops": {
      "url": "https://app.airops.com/mcp"
    }
  }
}
```

3. Clique em **Conectar** para autenticar

## VS Code (Copilot)

1. Abrir **Definições** (Ctrl/Cmd + ,)
2. Procure por "mcp" e clique em **Editar em settings.json**
3. Adicione:

```json
{
  "mcp": {
    "servers": {
      "airops": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
      }
    }
  }
}
```

## Windsurf

1. Abrir **Definições do Windsurf → Cascade → Servidores MCP**
2. Clique em **Adicionar servidor → Adicionar servidor personalizado**
3. Adicione:

```json
{
  "mcpServers": {
    "airops": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
    }
  }
}
```

## Outros clientes

A maioria dos clientes MCP suporta transporte HTTP:

* **Transporte:** HTTP (streamable HTTP)
* **URL:** `https://app.airops.com/mcp`

Para clientes que exigem transporte SSE, use `mcp-remote` como proxy:

```bash
npx -y mcp-remote https://app.airops.com/mcp
```

## Resolução de problemas

### Autenticação

<details>

<summary>Erro "É necessária autenticação"</summary>

**Claude Code:** Executar `/mcp`, selecione AirOps, escolha **Autenticar**.

**Cursor:** Clique em **Conectar** botão nas definições de MCP.

**Outros clientes:** Remova e adicione novamente o servidor para limpar os tokens em cache.

</details>

<details>

<summary>OAuth não está a funcionar (WSL/rede corporativa)</summary>

**Utilizadores de WSL:** O OAuth no navegador pode falhar a partir do WSL. Execute o seu cliente a partir do Windows em vez disso.

**Redes corporativas:** A sua rede pode bloquear os redirecionamentos OAuth. Experimente uma rede pessoal ou contacte o departamento de TI para colocar na lista branca `app.airops.com`.

</details>

### Ligação

<details>

<summary>Ligação recusada ou tempo limite excedido</summary>

Verifique se consegue aceder a `https://app.airops.com` no seu navegador. Algumas redes corporativas bloqueiam ligações MCP.

</details>

<details>

<summary>Ferramentas não aparecem</summary>

1. Reinicie o seu assistente de IA
2. **Claude Code:** Executar `/mcp` para verificar a ligação
3. Remova e adicione novamente o servidor

</details>

### Limpar autenticação em cache

Remova o servidor e adicione-o novamente:

**Claude Code:**

```bash
claude mcp remove airops
claude mcp add --transport http airops https://app.airops.com/mcp
```

**Outros clientes:** Elimine o servidor da sua configuração e adicione-o novamente.

## Próximos passos

* [Casos de utilização](/docs/pt/programadores/use-cases.md) — Exemplos de relatórios e otimização
* [Referência de ferramentas](/docs/pt/programadores/tools.md) — Todas as ferramentas disponíveis
* [Perguntas frequentes](/docs/pt/programadores/faq.md) — Perguntas frequentes


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/programadores/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.