TomTom Maps

Claude Code

1. Eseguilo in un terminale, nella cartella del tuo progetto:

claude mcp add --transport http tomtom https://mcp.tomtom.com/maps --header "tomtom-api-key: <YOUR_API_KEY>"

1. Sostituisci il segnaposto con la tua chiave prima di eseguirlo, poi controlla con /mcp dentro Claude Code.

Aggiungi --scope user per renderlo disponibile in tutti i progetti, non solo in questo.

Claude Desktop

1. I connettori personalizzati non possono inviare l’header della chiave di questo server, quindi usa il bridge mcp-remote. Apri Settings → Developer → Edit Config e aggiungi:

{
  "mcpServers": {
    "tomtom": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tomtom.com/maps",
        "--header",
        "tomtom-api-key: <YOUR_API_KEY>"
      ]
    }
  }
}

1. Sostituisci il segnaposto con la tua chiave e riavvia Claude Desktop.

Il bridge richiede Node.js sul tuo computer.

Cursor

Aggiungi a Cursor (si apre in una nuova scheda)

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

{
  "mcpServers": {
    "tomtom": {
      "url": "https://mcp.tomtom.com/maps",
      "headers": {
        "tomtom-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

VS Code

Aggiungilo a .vscode/mcp.json. VS Code chiede la chiave la prima volta e la conserva in modo sicuro:

{
  "servers": {
    "tomtom": {
      "type": "http",
      "url": "https://mcp.tomtom.com/maps",
      "headers": {
        "tomtom-api-key": "${input:tomtom-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "tomtom-api-key",
      "description": "tomtom-api-key",
      "password": true
    }
  ]
}

Devin Desktop

1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):

{
  "mcpServers": {
    "tomtom": {
      "serverUrl": "https://mcp.tomtom.com/maps",
      "headers": {
        "tomtom-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

1. Aggiorna l’elenco dei server MCP in Cascade.

Devin Desktop è il nuovo nome di Windsurf. Per i server remoti legge serverUrl (o url).

Codex

codex mcp add tomtom --url https://mcp.tomtom.com/maps

Oppure modifica direttamente ~/.codex/config.toml:

[mcp_servers.tomtom]
url = "https://mcp.tomtom.com/maps"
env_http_headers = { "tomtom-api-key" = "TOMTOM_API_KEY" }

Codex legge i valori degli header dalle variabili d’ambiente indicate in env_http_headers.

Gemini CLI

gemini mcp add --transport http --header "tomtom-api-key: <YOUR_API_KEY>" tomtom https://mcp.tomtom.com/maps

Così lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.

Qualsiasi client

La maggior parte dei client accetta questa forma. Alcuni chiamano diversamente il campo dell’URL: serverUrl in Devin Desktop, httpUrl nel file di impostazioni di Gemini CLI.

{
  "mcpServers": {
    "tomtom": {
      "type": "http",
      "url": "https://mcp.tomtom.com/maps",
      "headers": {
        "tomtom-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

Zed mette i server sotto context_servers nelle sue impostazioni. Cline ha bisogno di "type": "streamableHttp", altrimenti presume SSE.

Il tuo client avvia solo server locali? Collegalo con npx -y mcp-remote https://mcp.tomtom.com/maps.

Badge per il README

[![TomTom Maps on mcp.tc](https://mcp.tc/i/tomtom/badge.svg)](https://mcp.tc/i/tomtom)

<a href="https://mcp.tc/i/tomtom"><img src="https://mcp.tc/i/tomtom/badge.svg" alt="TomTom Maps on mcp.tc" height="20"></a>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Scheda per il sito

<script src="https://mcp.tc/w/tomtom.js" async></script>

La scheda compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.

iframe

<iframe src="https://mcp.tc/embed/tomtom" title="TomTom Maps on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, URL del server, tool e i link «Aggiungi a». Qualsiasi sito può leggerla (CORS aperto).

https://mcp.tc/i/tomtom.json

Cosa significa ogni campo