# Configurazione MCP (/it/mcp-server)





<McpCallout className="my-2" showLink="false" />

Il server MCP di Tapaya Docs consente ad agenti AI e IDE di cercare in questa documentazione ed esplorare direttamente la REST API di Tapaya, senza uscire dal Suo editor. È di sola lettura, pubblico e non richiede alcuna chiave API né alcun secret.

## URL del server [#server-url]

<ServerUrl url="https://docs.tapaya.com/mcp" />

Il server utilizza Streamable HTTP e funziona con qualsiasi client MCP. Per i client che supportano il rilevamento MCP tramite well-known è inoltre pubblicato un manifest di rilevamento su [`/.well-known/mcp.json`](/.well-known/mcp.json).

## Collegare il client [#connect-your-client]

<Tabs items="['Claude Code', 'Cursor', 'VS Code', 'Claude Desktop', 'Other']">
  <Tab value="Claude Code">
    Installi il plugin (consigliato):

    ```bash
    claude plugin marketplace add tapayadot/tapaya-mcp
    claude plugin install tapaya-docs@tapaya
    ```

    Oppure aggiunga il server direttamente, senza il plugin:

    ```bash
    claude mcp add --transport http tapaya-docs https://docs.tapaya.com/mcp
    ```

    Quindi verifichi che sia collegato:

    ```bash
    claude mcp list
    ```
  </Tab>

  <Tab value="Cursor">
    <McpInstallButton client="cursor" className="mb-4" />

    Oppure aggiunga manualmente quanto segue a `~/.cursor/mcp.json`:

    ```json
    {
      "mcpServers": {
        "tapaya-docs": {
          "url": "https://docs.tapaya.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="VS Code">
    <McpInstallButton client="vscode" className="mb-4" />

    Oppure aggiunga manualmente quanto segue a `.vscode/mcp.json` nel Suo workspace:

    ```json
    {
      "servers": {
        "tapaya-docs": {
          "type": "http",
          "url": "https://docs.tapaya.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="Claude Desktop">
    Aggiunga quanto segue alla configurazione MCP di Claude Desktop:

    ```json
    {
      "mcpServers": {
        "tapaya-docs": {
          "url": "https://docs.tapaya.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab value="Other">
    MCP è un protocollo aperto. Configuri qualsiasi client Streamable HTTP con l'URL del server `https://docs.tapaya.com/mcp`. Può elencare gli strumenti disponibili con una richiesta diretta:

    ```bash
    curl -s https://docs.tapaya.com/mcp \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
    ```
  </Tab>
</Tabs>

## Strumenti disponibili [#available-tools]

| Risorsa           | Strumento              | Descrizione                                                     |
| ----------------- | ---------------------- | --------------------------------------------------------------- |
| **Strumenti API** | `search_docs`          | Ricerca full-text in tutte le pagine della documentazione.      |
|                   | `get_page`             | Recupera il Markdown completo di una pagina in base al suo URL. |
|                   | `list_pages`           | Elenca tutte le pagine con titolo, URL e descrizione.           |
|                   | `search_api_endpoints` | Cerca nella REST API di Tapaya per parola chiave.               |
|                   | `get_api_endpoint`     | Restituisce i parametri e le risposte completi di un endpoint.  |

## Note e sicurezza [#notes-and-safety]

> Questo server è di sola lettura. Non chiama mai la Tapaya API live e non chiede mai chiavi API o secret.

Quando combina più server MCP, adotti le consuete precauzioni contro la prompt injection proveniente dall'output degli strumenti e abiliti la conferma umana per gli strumenti, se il Suo client lo supporta.

Ha trovato un problema o desidera un altro strumento? Apra una issue nel repository della documentazione.