> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

> Ligue o apinn ao seu assistente de IA (Claude, Cursor…) através do servidor MCP.

O apinn expõe um **servidor MCP** (Model Context Protocol): o seu assistente de IA pode **pesquisar na documentação** e **chamar a API** (listar os desportos, obter as odds de um jogo, o histórico, os specials…) diretamente em linguagem natural.

<Info>
  URL do servidor MCP: **`https://docs.apinn.io/mcp`** (transporte HTTP streamable).
</Info>

## Ligar o servidor

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http apinn https://docs.apinn.io/mcp
    ```

    Depois, numa sessão: «lista os jogos de futebol em direto», «dá-me as odds do evento 1632003656».
  </Tab>

  <Tab title="Cursor">
    Adicione a `~/.cursor/mcp.json` (ou *Settings → MCP → Add* ):

    ```json theme={null}
    {
      "mcpServers": {
        "apinn": {
          "url": "https://docs.apinn.io/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Em `claude_desktop_config.json` (Settings → Developer → Edit Config):

    ```json theme={null}
    {
      "mcpServers": {
        "apinn": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.apinn.io/mcp"]
        }
      }
    }
    ```

    Reinicie o Claude Desktop; o servidor `apinn` aparece na lista de ferramentas.
  </Tab>

  <Tab title="Outro cliente MCP">
    Qualquer cliente compatível com MCP (transporte **HTTP streamable**) pode ligar-se a:

    ```
    https://docs.apinn.io/mcp
    ```
  </Tab>
</Tabs>

## Autenticação

* As ferramentas de **pesquisa de documentação** funcionam sem chave.
* As ferramentas que **chamam a API** utilizam a sua **chave apinn** (`X-API-Key`). Forneça-a ao assistente / na configuração do cliente MCP quando ele a pedir. Cada chamada conta para a sua [quota horária](/pt/rate-limits).

<Warning>
  Nunca cole a sua chave num repositório público ou numa partilha de ecrã. Trate-a como um segredo.
</Warning>

## O que o assistente pode fazer

* «Quais são os desportos disponíveis?» → `/api/sports`
* «Dá-me os jogos de futebol em direto» → `/api/fixtures?sport_id=29&live=1`
* «Odds atuais do evento 1632003656» → `/api/odds`
* «Histórico completo das odds deste jogo» → `/api/odds?full_history=1`
* «Vencedor da Champions League: odds dos favoritos» → `/api/specials/outrights`

Todos os [endpoints da referência da API](/pt/api-reference/introduction) estão expostos como ferramentas MCP (apenas leitura).