Come collegare Postman a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Postman, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Postman + Gemini

Lavora con Postman dal tuo agente AI: consulta workspace, collection, cartelle e request, environment, specifiche Spec Hub e API, mock server con i loro call log, monitor e utenti del team, cerca in tutto, e crea o modifica collection, request, environment, mock, monitor e spec dopo la tua conferma.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

POSTMAN_API_URL, POSTMAN_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Postman con accesso ai workspace.

1. In Postman apri il tuo avatar, Settings, API keys (https://go.postman.co/settings/me/api-keys) e fai clic su Generate API Key. Dagli un nome e copia la chiave; inizia con PMAK-.
2. Incollala in POSTMAN_API_KEY. Viene inviata nell'header X-Api-Key e agisce come il tuo utente Postman: l'AI vede ciò che vedi tu in ogni workspace.
3. Imposta POSTMAN_API_URL su https://api.postman.com, oppure su https://api.eu.postman.com se il tuo team ha un piano Enterprise nella regione dati UE di Postman.
4. Installa il connettore ed esegui postman_get_me: mostra il tuo user id, il team e l'utilizzo mensile delle API, e conferma la chiave.

Id e uid: la maggior parte degli oggetti ha un id e un uid (<owner user id>-<id>). Mock, monitor e postman_update_collection vogliono l'uid della collection; postman_create_collection_request, postman_update_collection_request e postman_create_collection_folder l'id semplice. Le altre letture accettano entrambi.

Cosa legge:

• Tu e il tuo team: postman_get_me, postman_list_workspaces (con createdBy impostato sul tuo user id per "i miei workspace"), postman_get_workspace (le collection, gli environment, i mock, i monitor e le API che contiene), postman_list_team_users e postman_search, che trova request, collection, workspace, environment, documenti, flow o spec per testo (di default solo nel tuo team, quelli pubblici con ownership).
• Collection in Postman Collection Format v2.1: postman_list_collections, postman_get_collection (per quelle grandi prima model=minimal), postman_get_collection_folder e postman_get_collection_request con metodo, URL, header, body, auth e script.
• Environment: postman_list_environments e postman_get_environment con chiave, valore, tipo e flag enabled di ogni variabile.
• Design delle API: Spec Hub con postman_list_specs, postman_get_spec, postman_list_spec_files, postman_get_spec_file e postman_get_spec_definition (l'intera definizione OpenAPI o AsyncAPI risolta); le API del vecchio API Builder con postman_list_apis e postman_get_api.
• Mock: postman_list_mocks, postman_get_mock e postman_get_mock_call_logs, cioè cosa i client hanno inviato al mock e cosa ha risposto (al massimo 100 log o 6,5 MB per chiamata; header e body solo con include).
• Monitor: postman_list_monitors e postman_get_monitor, il cui lastRun mostra l'ultimo stato, gli orari e le asserzioni superate e fallite.

Cosa scrive, dopo la tua conferma: postman_create_collection, postman_update_collection (nome, descrizione, variabili, auth; cartelle e request restano come sono), postman_create_collection_folder, postman_create_collection_request, postman_update_collection_request (i campi passati sostituiscono quelli vecchi), postman_create_environment, postman_update_environment, postman_create_mock, postman_create_monitor, postman_run_monitor, postman_create_spec (OpenAPI, AsyncAPI, protobuf, GraphQL, Smithy) e postman_update_spec_file. L'AI dice cosa creerà o modificherà e in quale workspace, e chiama il tool solo dopo il tuo sì. Tutto ciò che scrive è visibile ai membri del workspace. Tieni presente che:

• postman_run_monitor invia le request reali della collection alle loro API e consuma un'esecuzione di monitoraggio del tuo piano; postman_create_monitor continua a farlo secondo la sua pianificazione.
• Un nuovo mock è pubblico se private non è true.
• postman_update_environment accetta operazioni JSON Patch di un solo tipo per chiamata; l'AI legge prima l'environment per conoscere le posizioni delle variabili (values[0] è /values/0).
• L'API di Postman non può eseguire una collection direttamente. Usa un monitor, oppure la Postman CLI nella tua CI.

Tutti i 35 tool sono attivi dopo l'installazione; nessuno è disattivato, e nessun tool elimina workspace, collection, request, environment, mock, monitor o spec.

Segreti: le variabili di environment di tipo secret tornano con il loro valore quando sono condivise, e le variabili di collection o l'auth delle request possono contenere token. L'AI non ripete questi valori se non glielo chiedi.

Formati dei dati: collection e request usano il Postman Collection Format v2.1 (item contiene cartelle e request). Le date sono ISO 8601 in UTC.

Paginazione: postman_list_workspaces, postman_list_apis, postman_list_specs, postman_list_monitors, postman_get_mock_call_logs e postman_search restituiscono meta.nextCursor; l'AI richiama con cursor finché è vuoto. postman_list_collections pagina con limit e offset; il suo filtro name cerca il nome esatto e non si combina con essi.

Limiti: Postman consente 300 richieste al minuto per utente; postman_list_collections, postman_list_workspaces, postman_get_workspace e gli endpoint dei monitor solo 10 chiamate in 10 secondi. Ogni piano ha anche una quota mensile di chiamate API, che postman_get_me mostra sotto operations. Un 429 con rateLimited significa aspettare (Retry-After indica i secondi); serviceLimitExhausted significa che la quota del piano è esaurita e deve intervenire un admin del team.

Errori comuni: 401 indica una chiave errata, scaduta o revocata, oppure appartenente all'altra regione dati (controlla POSTMAN_API_URL). 403 indica che il tuo ruolo in quel workspace non consente la chiamata. 404 indica che l'id non esiste o che non puoi vederlo. 400 indica il campo sbagliato, per esempio un id di collection dove serve un uid.

Il connettore non elimina nulla e non gestisce fork e pull request, commenti, tag, governance, l'API catalog, la private API network, SCIM, audit log, fatturazione né le scritture del vecchio API Builder.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Postman.

Tool disponibili

Esempi di prompt

• "Quali collection ci sono nel nostro workspace Payments, e quali request contiene la collection Checkout?"
• "Il monitor notturno della API ordini ha superato l'ultima esecuzione? Quante asserzioni sono fallite?"
• "Mostrami le ultime 20 chiamate al nostro mock server di checkout che hanno ricevuto un 404."
• "Aggiungi alla collection Payments una request POST 'Create refund' con un body JSON per orderId e amount."
• "Dammi la definizione OpenAPI risolta della spec Orders ed elenca i suoi endpoint."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot