Server MCP in hosting
Configuralo in un minuto
- Copia il tuo token API dalle impostazioni del tuo account.
- Scegli il tuo strumento qui sotto e incolla lo snippet, sostituendo il token segnaposto.
- Riavvia il tuo strumento di IA e chiedigli qualcosa come: «Qual è il genere probabile del nome Andrea in Italia?»
Esegui questo singolo comando nel terminale — è tutta la configurazione.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Aggiungi --scope user per rendere Gender-API disponibile in tutti i tuoi progetti e non solo in quello attuale.
Claude Desktop si collega tramite un piccolo ponte npm che viene scaricato automaticamente. Aggiungi questo al tuo file di configurazione — nessuna installazione manuale.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Posizione del file di configurazione:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Scrivi Authorization:Bearer senza spazio dopo i due punti — è così che se lo aspetta il ponte.
Aggiungi questo in ~/.cursor/mcp.json per tutti i progetti, oppure in .cursor/mcp.json per un singolo progetto.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Aggiungi questo in .vscode/mcp.json nel tuo progetto, oppure nel mcp.json a livello utente per abilitarlo dappertutto.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code usa servers invece di mcpServers e si aspetta gli header dentro requestInit. La stessa struttura funziona in Visual Studio e negli IDE JetBrains.
Qualsiasi client che supporta MCP remoto ha bisogno solo di questi tre valori:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Se il tuo client supporta solo server MCP locali, usa il ponte npx mcp-remote mostrato nella scheda Claude Desktop — funziona con qualsiasi client solo stdio.
Usa Gender-API direttamente negli strumenti di intelligenza artificiale
Il nostro Server MCP permette agli strumenti di IA compatibili con MCP di chiamare Gender-API direttamente. Questo significa che il tuo assistente può arricchire nomi, nomi completi, nomi ricavati dalle email e dati sul paese di origine tramite chiamate a strumenti strutturate, invece di affidarsi solo alle istruzioni nel prompt.
Non c'è niente da installare né da ospitare: punta il tuo strumento a https://mcp.gender-api.com e autenticati con lo stesso token Gender-API che usi già per l'API.
Cosa puoi farci con questo
- Usa i dati live di Gender-API: Il tuo strumento di IA può interrogare i risultati live di Gender-API invece di inventare formati di richiesta o risposte.
- Riutilizza il tuo token esistente: Il server MCP funziona con lo stesso bearer token di Gender-API che già usi per l’API.
- Collega client compatibili con MCP: Puoi usarlo in Claude, Cursor o nei tuoi strumenti e agenti interni compatibili con MCP che supportano URL MCP ospitati.
- Mantieni la fatturazione semplice: Si applica comunque il normale utilizzo dei crediti di Gender-API, quindi non c’è nessun secondo sistema di fatturazione da imparare.
Strumenti supportati
Strumenti MCP inclusi
- query_first_name – Interroga il genere probabile in base al nome.
- query_full_name – Interroga il gender probabile in base al nome completo.
- query_email – Estrai e arricchisci un nome da un indirizzo email.
- get_country_of_origin – Ottieni i probabili paesi di origine.
- get_statistics – Controlla i crediti rimanenti e le statistiche dell’account.
Trasporto ospitato
Usa l'endpoint Streamable HTTP ospitato su https://mcp.gender-api.com e autenticati con il tuo token bearer Gender-API.
Casi d’uso MCP nel mondo reale
Arricchimento dei lead all’interno dei copiloti AI
Lascia che Claude, Cursor o un agente di vendita interno analizzi un elenco di lead, interroghi Gender-API tramite MCP e aggiunga probabili nomi di battesimo, gender e contesto sul paese d’origine prima di contattarli.
Personalizzazione del CRM e dell’assistenza clienti
Il tuo assistente di supporto può analizzare gli indirizzi email in arrivo, estrarre i nomi propri più probabili con `query_email` e creare bozze di risposta più naturali e personalizzate per i tuoi operatori.
Agenti per la pulizia dei fogli di calcolo e la ricerca
Gli agenti di pulizia dei dati con supporto MCP possono analizzare file CSV o fogli di calcolo, standardizzare le colonne dei nomi (nome di battesimo) e arricchire le righe con i risultati di Gender-API, senza dover scrivere codice API personalizzato in ogni workflow.
Automazione del marketing e segmentazione
Usa MCP negli assistenti per la creazione di campagne per generare saluti, arricchire i dati dei contatti e controllare i crediti rimanenti prima di avviare un flusso di lavoro di personalizzazione.
Stai sviluppando un tuo client MCP?
Collegarsi con l'SDK MCP ufficiale
Se stai scrivendo un tuo agente invece di usare uno strumento già pronto, collega direttamente il transport Streamable HTTP:
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const transport = new StreamableHTTPClientTransport(new URL('https://mcp.gender-api.com'), {
requestInit: {
headers: {
Authorization: 'Bearer YOUR_API_TOKEN',
},
},
});
Domande frequenti
Usa i miei crediti Gender-API normali?
Sì. Il server MCP è un sottile livello di integrazione sopra gli endpoint Gender-API esistenti, quindi si applicano ancora le normali autorizzazioni del token e l’utilizzo dei crediti.
Posso usarlo nel mio tool MCP interno?
Sì. Se il tuo strumento supporta MCP ospitato, collegalo a https://mcp.gender-api.com e invia il tuo token bearer Gender-API.
Devo installare qualcosa?
No. Il server MCP è ospitato da noi, quindi non c'è niente da scaricare o da tenere in esecuzione. I client che supportano solo server MCP locali usano il ponte npx mcp-remote, che si scarica da solo al primo avvio.
Il mio strumento di IA non mostra gli strumenti Gender-API. Che faccio?
Riavvia lo strumento dopo aver modificato la sua configurazione e ricontrolla di aver sostituito il token segnaposto con il tuo vero token API. Se la connessione viene rifiutata, il tuo token non è valido o ha esaurito i crediti — in entrambi i casi compare come errore di autenticazione.
Hai qualche domanda?
