> ## 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

> Conecta Claude, Cursor y otros agentes a FlexInference a través del Protocolo de Contexto del Modelo.

Usa el servidor del Protocolo de Contexto del Modelo (MCP) de FlexInference para permitir que los agentes de codificación lean la documentación y realicen acciones de cuenta aprobadas. Es un servidor HTTP remoto y con capacidad de streaming en:

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

El servidor expone dos grupos de herramientas. Las herramientas de documentación se ejecutan sin necesidad de iniciar sesión. Las herramientas de cuenta requieren OAuth, con un ámbito por herramienta, antes de que un agente pueda leer el uso o gestionar las claves.

<Note>
  El servidor MCP es independiente de la API de inferencia en
  `https://api.flexinference.com/v1`. Nunca ejecuta inferencias ni ve tus
  prompts o respuestas. Solo gestiona la documentación y las acciones de la
  cuenta.
</Note>

## Conectar

Añade el servidor a cualquier cliente MCP que admita servidores HTTP remotos, incluidos Claude y Cursor. Usa esta configuración:

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

La primera llamada a una herramienta de cuenta abre un navegador para iniciar sesión en el panel de control, luego muestra una pantalla de consentimiento con los ámbitos solicitados. Aprueba o restringe los ámbitos, y el cliente almacenará el token. Las herramientas de documentación no requieren autenticación.

## Herramientas

### Herramientas de documentación (sin inicio de sesión)

| Tool                  | Arguments          | What it does                                                                                                                       |
| :-------------------- | :----------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
| `search_docs`         | `query` (required) | Busca en la documentación de FlexInference y en el catálogo completo de errores, y devuelve las mejores coincidencias con enlaces. |
| `get_error_reference` | `code` (optional)  | Busca el significado de un código de error de FlexInference y cómo solucionarlo. Omite `code` para listar todos los códigos.       |

### Herramientas de cuenta (OAuth, un ámbito cada una)

| Tool                 | Scope          | Arguments          | What it does                                                                                                                    |
| :------------------- | :------------- | :----------------- | :------------------------------------------------------------------------------------------------------------------------------ |
| `get_usage_summary`  | `usage:read`   | none               | Tu uso y ahorros de flex, desglosados por modelo.                                                                               |
| `list_api_keys`      | `keys:read`    | none               | Tus claves API activas por nombre, los últimos 4 caracteres y fecha de creación. Nunca la clave completa.                       |
| `create_api_key`     | `keys:write`   | `name` (required)  | Crea una nueva clave `flex_live_`. La clave completa se devuelve una sola vez.                                                  |
| `revoke_api_key`     | `keys:write`   | `keyId` (required) | Revoca una clave por su ID.                                                                                                     |
| `get_byok_status`    | `byok:status`  | none               | Qué proveedores tienen una clave registrada, como un sí o no por proveedor. Nunca la clave.                                     |
| `get_billing_status` | `billing:read` | none               | Tu método de pago (solo marca y los últimos 4 dígitos), estado de la cuenta, comisión acumulada y próxima fecha de facturación. |

## Autenticación y ámbitos

El servidor implementa OAuth 2.1 contra el mismo sistema de identidad que el panel de control, por lo que un agente se asigna a la misma organización. Cada herramienta de cuenta requiere exactamente un ámbito. La pantalla de consentimiento te permite aprobar o restringir los ámbitos solicitados.

El servidor no utiliza cookies ni sesiones del lado del servidor. Cada llamada a una herramienta lleva su propio token, y cada herramienta verifica su ámbito antes de leer o cambiar datos.

| Scope          | Grants                                                                                           |
| :------------- | :----------------------------------------------------------------------------------------------- |
| `docs:read`    | Busca en la documentación y lee el catálogo de errores. Concedido a todos, sin inicio de sesión. |
| `usage:read`   | Lee tu uso y ahorros.                                                                            |
| `keys:read`    | Lista tus claves API.                                                                            |
| `keys:write`   | Crea y revoca claves API.                                                                        |
| `byok:status`  | Lee qué proveedores tienen una clave registrada.                                                 |
| `billing:read` | Lee tu estado de facturación.                                                                    |

<Warning>
  El servidor MCP nunca acepta una clave de proveedor sin procesar. Las claves
  BYOK se almacenan cifradas y no se envían por solicitud. No existe un ámbito
  de escritura para BYOK, y ninguna herramienta acepta un valor `sk-...`,
  `AIza...` o `sk-ant-...`. `get_byok_status` solo informa sí o no por
  proveedor. Añade o rota las claves de proveedor en el [panel de
  control](https://www.flexinference.com/dashboard).
</Warning>