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

# Solución de problemas del servidor MCP

> Corrige fallos de conexión, errores de autenticación, denegaciones de scope y herramientas faltantes al conectar un agente con Formpaste.

La mayoría de los problemas de MCP caen en unas pocas categorías. Relaciona el síntoma con la causa de abajo.

| Síntoma                                             | Causa probable                                                | Solución                                                                                                                                                              |
| --------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| El cliente no puede conectar / conexión rechazada   | Host de endpoint incorrecto                                   | El endpoint es `https://api.formpaste.com/mcp` (ten en cuenta `api.`, no `app.`).                                                                                     |
| La llamada a la herramienta devuelve `unauthorized` | Token faltante, mal escrito o revocado                        | Genera un nuevo token en **Settings → API & MCP** y actualiza la configuración de tu cliente. El token se muestra una sola vez.                                       |
| Una herramienta de lectura devuelve `forbidden`     | Un token con scope de setup llamó a `list_submissions`        | Los tokens de setup no pueden leer submissions. Usa un token de acceso completo, o genera uno. Consulta [tokens de API](/docs/agents/api-tokens).                          |
| La llamada a la herramienta devuelve `not_found`    | `formId` incorrecto, o un formulario de otra cuenta           | Llama a [`list_forms`](/docs/agents/list-forms) para obtener ids válidos para la cuenta del token.                                                                         |
| `formpaste` no aparece tras la instalación          | El cliente no se reinició, o `mcp-remote` está desactualizado | Reinicia el cliente. Si el problema persiste, limpia la caché de `mcp-remote` (`npx clear-npx-cache`) y vuelve a conectar.                                            |
| Solo aparecen tres herramientas                     | Una conexión antigua en caché                                 | Vuelve a conectar - el servidor actual expone seis herramientas (`create_form`, `get_snippet`, `list_forms`, `get_form`, `send_test_submission`, `list_submissions`). |

## La estructura del error

Cada error de herramienta es un objeto JSON sobre el que un agente puede ramificar:

```json theme={null}
{ "error": { "code": "not_found", "message": "No form with that id on your account.", "hint": "Call list_forms to see your form ids." } }
```

El `code` es uno de un conjunto fijo: `unauthorized`, `forbidden`, `not_found`, `invalid_input`,
`invalid_framework`, `too_many_fields`, `field_too_large`, `internal_error`.

<CardGroup cols={2}>
  <Card title="Instalación" icon="download" href="/docs/agents/install">
    Comandos de instalación por cliente.
  </Card>

  <Card title="Tokens de API" icon="key" href="/docs/agents/api-tokens">
    Scopes de token completo vs. de setup.
  </Card>
</CardGroup>