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

# Servidor MCP

> Conecte Claude, Cursor e outros agentes ao FlexInference através do Protocolo de Contexto de Modelo.

Use o servidor do Protocolo de Contexto de Modelo (MCP) do FlexInference para permitir que agentes de codificação leiam a documentação e realizem ações de conta aprovadas. É um servidor HTTP remoto e streamable em:

```
https://mcp.flexinference.com/mcp
```

O servidor expõe dois grupos de ferramentas. As ferramentas de documentação funcionam sem login. As ferramentas de conta exigem OAuth, com um escopo por ferramenta, antes que um agente possa ler o uso ou gerenciar chaves.

<Note>
  O servidor MCP é separado da API de inferência em
  `https://api.flexinference.com/v1`. Ele nunca executa inferência e nunca vê
  seus prompts ou respostas. Ele apenas lida com a documentação e ações da conta.
</Note>

## Conectar

Adicione o servidor a qualquer cliente MCP que suporte servidores HTTP remotos, incluindo Claude e Cursor. Use esta configuração:

<CodeGroup>
  ```json mcp.json theme={null}
  {
    "mcpServers": {
      "flexinference": {
        "type": "http",
        "url": "https://mcp.flexinference.com/mcp"
      }
    }
  }
  ```

  ```bash Claude Code theme={null}
  claude mcp add --transport http flexinference https://mcp.flexinference.com/mcp
  ```
</CodeGroup>

A primeira chamada de ferramenta de conta abre um navegador para login no painel, e então mostra uma tela de consentimento com os escopos solicitados. Aprove ou restrinja os escopos, e o cliente armazenará o token. As ferramentas de documentação não exigem autenticação.

## Ferramentas

### Ferramentas de documentação (sem login)

| Tool                  | Arguments          | O que faz                                                                                                                  |
| --------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| `search_docs`         | `query` (required) | Pesquise a documentação do FlexInference e o catálogo completo de erros, e retorne as melhores correspondências com links. |
| `get_error_reference` | `code` (optional)  | Consulte o significado de um código de erro do FlexInference e como corrigi-lo. Omita `code` para listar todos os códigos. |

### Ferramentas de conta (OAuth, um escopo cada)

| Tool                 | Scope          | Arguments          | O que faz                                                                                                                   |
| -------------------- | -------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `get_usage_summary`  | `usage:read`   | none               | Seu uso e economia de flex, detalhados por modelo.                                                                          |
| `list_api_keys`      | `keys:read`    | none               | Suas chaves de API ativas por nome, últimos 4 caracteres e data de criação. Nunca a chave completa.                         |
| `create_api_key`     | `keys:write`   | `name` (required)  | Crie uma nova chave `flex_live_`. A chave completa é retornada uma vez.                                                     |
| `revoke_api_key`     | `keys:write`   | `keyId` (required) | Revogue uma chave pelo seu ID.                                                                                              |
| `get_byok_status`    | `byok:status`  | none               | Quais provedores têm uma chave arquivada, como sim ou não por provedor. Nunca a chave.                                      |
| `get_billing_status` | `billing:read` | none               | Seu método de pagamento (apenas marca e últimos 4 dígitos), status da conta, comissão acumulada e próxima data de cobrança. |

## Autenticação e escopos

O servidor implementa OAuth 2.1 contra o mesmo sistema de identidade do painel, então um agente é mapeado para a mesma organização. Cada ferramenta de conta requer exatamente um escopo. A tela de consentimento permite que você aprove ou restrinja os escopos solicitados.

O servidor não usa cookies ou sessões do lado do servidor. Cada chamada de ferramenta carrega seu próprio token, e cada ferramenta verifica seu escopo antes de ler ou alterar dados.

| Scope          | Concede                                                                           |
| -------------- | --------------------------------------------------------------------------------- |
| `docs:read`    | Pesquisar a documentação e ler o catálogo de erros. Concedido a todos, sem login. |
| `usage:read`   | Ler seu uso e economia.                                                           |
| `keys:read`    | Listar suas chaves de API.                                                        |
| `keys:write`   | Criar e revogar chaves de API.                                                    |
| `byok:status`  | Ler quais provedores têm uma chave arquivada.                                     |
| `billing:read` | Ler seu status de cobrança.                                                       |

<Warning>
  O servidor MCP nunca aceita uma chave de provedor bruta. As chaves BYOK são armazenadas
  criptografadas e não são enviadas por solicitação. Não há escopo de escrita para BYOK, e
  nenhuma ferramenta aceita um valor `sk-...`, `AIza...` ou `sk-ant-...`. `get_byok_status`
  informa apenas sim ou não por provedor. Adicione ou rotacione as chaves do provedor no
  [painel](https://www.flexinference.com/dashboard).
</Warning>