Hostowany serwer MCP
Skonfiguruj w minutę
- Skopiuj swój token API z ustawień konta.
- Wybierz poniżej swoje narzędzie i wklej fragment kodu, zastępując token przykładowy swoim.
- Zrestartuj swoje narzędzie AI i zapytaj je o coś w stylu: „Jaka jest prawdopodobna płeć dla imienia Andrea we Włoszech?”
Uruchom to jedno polecenie w terminalu — to cała konfiguracja.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Dodaj --scope user, aby Gender-API było dostępne we wszystkich Twoich projektach, a nie tylko w bieżącym.
Claude Desktop łączy się przez mały mostek npm, który pobiera się automatycznie. Dodaj to do swojego pliku konfiguracyjnego — ręczna instalacja nie jest potrzebna.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Lokalizacja pliku konfiguracyjnego:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Zapisz Authorization:Bearer bez spacji po dwukropku — tak tego oczekuje mostek.
Dodaj to w ~/.cursor/mcp.json dla wszystkich projektów albo w .cursor/mcp.json w pojedynczym projekcie.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Dodaj to w .vscode/mcp.json w swoim projekcie albo w mcp.json na poziomie użytkownika, aby włączyć to wszędzie.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code używa servers zamiast mcpServers i oczekuje nagłówków wewnątrz requestInit. Ta sama struktura działa w Visual Studio i w IDE JetBrains.
Każdy klient obsługujący zdalne MCP potrzebuje tylko tych trzech wartości:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Jeśli Twój klient obsługuje wyłącznie lokalne serwery MCP, użyj mostka npx mcp-remote pokazanego w zakładce Claude Desktop — działa z każdym klientem obsługującym tylko stdio.
Używaj Gender-API bezpośrednio w narzędziach AI
Nasz serwer MCP pozwala narzędziom AI zgodnym z MCP wywoływać Gender-API bezpośrednio. Dzięki temu Twój asystent może wzbogacać imiona, pełne imiona i nazwiska, imiona wyciągnięte z adresu e-mail oraz dane o kraju pochodzenia — poprzez ustrukturyzowane wywołania narzędzi, zamiast polegać wyłącznie na instrukcjach w promptach.
Nie ma nic do instalowania ani hostowania: skieruj swoje narzędzie na https://mcp.gender-api.com i uwierzytelnij się tym samym tokenem Gender-API, którego już używasz do API.
Co możesz dzięki temu zrobić jako klient
- Korzystaj z danych Gender-API na żywo: Twoje narzędzie AI może pobierać aktualne wyniki z Gender-API na żywo, zamiast wymyślać formaty zapytań lub odpowiedzi.
- Użyj ponownie swojego istniejącego tokena: Serwer MCP działa z tym samym tokenem bearer Gender-API, którego już używasz w API.
- Połącz klientów zgodnych z MCP: Możesz tego używać w Claude, Cursorze albo we własnych wewnętrznych narzędziach i agentach zgodnych z MCP, które obsługują hostowane adresy URL MCP.
- Uprość rozliczenia: Nadal obowiązuje standardowe zużycie kredytów Gender-API, więc nie musisz uczyć się drugiego systemu rozliczeń.
Obsługiwane narzędzia
Dołączone narzędzia MCP
- query_first_name – Sprawdź prawdopodobną płeć na podstawie imienia.
- query_full_name – Sprawdź prawdopodobną płeć na podstawie pełnego imienia i nazwiska.
- query_email – Wyodrębnij i uzupełnij imię na podstawie adresu e-mail.
- get_country_of_origin – Poznaj prawdopodobne kraje pochodzenia.
- get_statistics – Sprawdź pozostałe kredyty oraz statystyki konta.
Transport hostowany
Użyj hostowanego endpointu Streamable HTTP pod adresem https://mcp.gender-api.com i uwierzytelnij się swoim tokenem bearer Gender-API.
Przykłady zastosowań MCP w prawdziwym świecie
Wzbogacanie leadów w ramach kopilotów AI
Pozwól Claude, Cursor albo wewnętrznemu handlowcowi przejrzeć listę leadów, wywołać Gender-API przez MCP i jeszcze przed pierwszym kontaktem uzupełnić ją o prawdopodobne imiona, gender oraz kontekst kraju pochodzenia.
Personalizacja CRM i wsparcia klienta
Twój asystent wsparcia może analizować przychodzące adresy e-mail, wyciągać prawdopodobne imiona za pomocą `query_email` i tworzyć bardziej naturalne, spersonalizowane szkice odpowiedzi dla konsultantów.
Agenci do porządkowania arkuszy kalkulacyjnych i researchu
Agenci do czyszczenia danych z obsługą MCP mogą przejrzeć pliki CSV lub arkusze kalkulacyjne, ujednolicić kolumny z imionami oraz wzbogacić wiersze o wyniki z Gender-API — bez pisania własnego kodu API w każdym workflow.
Automatyzacja marketingu i segmentacja
Korzystaj z MCP w asystentach do tworzenia kampanii, aby generować zwroty grzecznościowe, wzbogacać dane kontaktów i sprawdzać pozostałe kredyty przed uruchomieniem procesu personalizacji.
Tworzysz własnego klienta MCP?
Połącz się z oficjalnym SDK MCP
Jeśli piszesz własnego agenta, zamiast korzystać z gotowego narzędzia, podłącz transport Streamable HTTP bezpośrednio:
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',
},
},
});
Najczęściej zadawane pytania
Czy to wykorzystuje moje zwykłe kredyty Gender-API?
Tak. Serwer MCP to cienka warstwa integracyjna oparta na istniejących endpointach Gender-API, więc nadal obowiązują standardowe uprawnienia tokena oraz rozliczanie kredytów.
Czy mogę używać tego w moim własnym wewnętrznym narzędziu MCP?
Tak. Jeśli Twoje narzędzie obsługuje hostowane MCP, podłącz je do https://mcp.gender-api.com i wyślij swój token bearer Gender-API.
Czy muszę coś instalować?
Nie. Serwer MCP hostujemy my, więc nie ma czego pobierać ani utrzymywać uruchomionego. Klienty obsługujące tylko lokalne serwery MCP korzystają z mostka npx mcp-remote, który pobiera się sam przy pierwszym uruchomieniu.
Moje narzędzie AI nie pokazuje narzędzi Gender-API. Co teraz?
Zrestartuj narzędzie po zmianie jego konfiguracji i sprawdź jeszcze raz, czy zastąpiłeś przykładowy token swoim prawdziwym tokenem API. Jeśli połączenie zostanie odrzucone, Twój token jest nieprawidłowy albo nie ma kredytów — w obu przypadkach zobaczysz błąd uwierzytelniania.
Masz jakieś pytania?
