Hostovaný MCP server
Nastavíte za minutu
- Zkopírujte svůj API token z nastavení účtu.
- Vyberte si níže svůj nástroj a vložte úryvek kódu, přičemž zástupný token nahraďte svým.
- Restartujte svůj AI nástroj a zkuste se ho zeptat třeba: „Jaké pohlaví má pravděpodobně jméno Andrea v Itálii?“
Spusťte v terminálu tento jediný příkaz — to je celé nastavení.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Přidejte --scope user, aby bylo Gender-API dostupné ve všech vašich projektech, a nejen v tom aktuálním.
Claude Desktop se připojuje přes malý npm můstek, který se stáhne automaticky. Přidejte toto do svého konfiguračního souboru — ruční instalace není potřeba.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Umístění konfiguračního souboru:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Napište Authorization:Bearer bez mezery po dvojtečce — takto to můstek očekává.
Přidejte toto do ~/.cursor/mcp.json pro všechny projekty, nebo do .cursor/mcp.json v jednotlivém projektu.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Přidejte toto do .vscode/mcp.json ve svém projektu, nebo do mcp.json na úrovni uživatele, aby to fungovalo všude.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code používá servers místo mcpServers a očekává hlavičky uvnitř requestInit. Stejná struktura funguje ve Visual Studiu a v IDE od JetBrains.
Každý klient, který podporuje vzdálené MCP, potřebuje jen tyto tři hodnoty:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Pokud váš klient podporuje pouze lokální MCP servery, použijte můstek npx mcp-remote ukázaný v záložce Claude Desktop — funguje s každým klientem, který umí jen stdio.
Používejte Gender-API přímo v nástrojích s AI
Náš MCP server umožňuje nástrojům s AI kompatibilním s MCP volat Gender-API přímo. Váš asistent tak může obohacovat křestní jména, celá jména, jména získaná z e-mailových adres i data o zemi původu pomocí strukturovaných volání nástrojů místo pokynů zadaných jen v promptu.
Není co instalovat ani hostovat: nasměrujte svůj nástroj na https://mcp.gender-api.com a přihlaste se stejným Gender-API tokenem, jaký už používáte pro API.
Co s ním zákazníci mohou dělat
- Používejte živá data z Gender-API: Váš nástroj s AI si může vyžádat živé výsledky z Gender-API, místo aby si formáty požadavků nebo odpovědí vymýšlel.
- Využijte svůj existující token: MCP server funguje se stejným bearer tokenem Gender-API, který už používáte pro API.
- Připojte klienty kompatibilní s MCP: Můžete ho použít v Claude, Cursoru nebo ve svých vlastních interních nástrojích a agentech kompatibilních s MCP, které podporují hostované MCP adresy URL.
- Zachovejte si jednoduché účtování: Kredity Gender-API se spotřebovávají obvyklým způsobem, takže se nemusíte učit žádný druhý systém účtování.
Podporované nástroje
Zahrnuté nástroje MCP
- query_first_name – Zjistí pravděpodobné pohlaví podle křestního jména.
- query_full_name – Zjistí pravděpodobné pohlaví podle celého jména.
- query_email – Získá jméno z e-mailové adresy a obohatí ho.
- get_country_of_origin – Zjistí pravděpodobné země původu.
- get_statistics – Zkontroluje zbývající kredity a statistiky účtu.
Hostovaný přenos
Použijte hostovaný endpoint Streamable HTTP na adrese https://mcp.gender-api.com a přihlaste se svým existujícím Gender-API bearer tokenem.
Praktické případy použití MCP
Obohacování leadů v AI copilotech
Nechte Claude, Cursor nebo interního prodejního agenta projít seznam leadů, zavolat Gender-API přes MCP a před oslovením doplnit pravděpodobná křestní jména, pohlaví a kontext o zemi původu.
Personalizace v CRM a v podpoře
Váš asistent podpory může prozkoumat příchozí e-mailové adresy, získat pravděpodobná křestní jména pomocí `query_email` a připravit operátorům přirozenější personalizované návrhy odpovědí.
Agenti pro čištění tabulek a rešerše
Agenti pro čištění dat s podporou MCP mohou procházet soubory CSV nebo tabulky, sjednotit sloupce s křestními jmény a doplnit do řádků výsledky z Gender-API, aniž byste museli v každém pracovním postupu psát vlastní kód pro API.
Automatizace marketingu a segmentace
Použijte MCP v asistentech pro tvorbu kampaní: vygenerujete oslovení, obohatíte kontaktní data a před spuštěním personalizovaného pracovního postupu zkontrolujete zbývající kredity.
Stavíte vlastního MCP klienta?
Připojit se s oficiálním MCP SDK
Pokud si píšete vlastního agenta místo použití hotového nástroje, připojte transport Streamable HTTP přímo:
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',
},
},
});
Často kladené otázky
Spotřebovává to moje běžné kredity Gender-API?
Ano. MCP server je jen tenká integrační vrstva nad existujícími endpointy Gender-API, takže platí obvyklá oprávnění tokenu i obvyklá spotřeba kreditů.
Můžu ho použít ve svém vlastním interním nástroji MCP?
Ano. Pokud váš nástroj podporuje hostované MCP, připojte ho k https://mcp.gender-api.com a pošlete svůj Gender-API bearer token.
Musím něco instalovat?
Ne. MCP server hostujeme my, takže není co stahovat ani udržovat v běhu. Klienti, kteří podporují pouze lokální MCP servery, používají můstek npx mcp-remote, který se sám stáhne při prvním spuštění.
Můj AI nástroj nezobrazuje nástroje Gender-API. Co teď?
Po úpravě konfigurace nástroj restartujte a zkontrolujte, že jste zástupný token nahradili svým skutečným API tokenem. Pokud je připojení odmítnuto, váš token je neplatný nebo mu chybí kredity — obojí se projeví jako chyba přihlášení.
Máte nějaké otázky?
