Barındırılan MCP Sunucusu
Bir dakikada kur
- API token'ını hesap ayarlarından kopyala.
- Aşağıdan aracını seç ve kod parçasını yapıştır, token yerine kendi token'ını yaz.
- AI aracını yeniden başlat ve ona şöyle bir şey sor: “İtalya'da Andrea isminin cinsiyeti muhtemelen nedir?”
Terminalde şu tek komutu çalıştır — kurulumun tamamı bu.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Gender-API'yi sadece mevcut projede değil tüm projelerinde kullanmak için --scope user ekle.
Claude Desktop, otomatik olarak indirilen küçük bir npm köprüsü üzerinden bağlanır. Bunu yapılandırma dosyana ekle — elle kurulum gerekmez.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Yapılandırma dosyasının konumu:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Authorization:Bearer ifadesini iki nokta üst üsteden sonra boşluk bırakmadan yaz — köprü bu şekilde bekliyor.
Bunu tüm projeler için ~/.cursor/mcp.json dosyasına, ya da tek bir proje içinde .cursor/mcp.json dosyasına ekle.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Bunu projendeki .vscode/mcp.json dosyasına, ya da her yerde etkin olması için kullanıcı düzeyindeki mcp.json dosyasına ekle.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code, mcpServers yerine servers kullanır ve başlıkları requestInit içinde bekler. Aynı yapı Visual Studio ve JetBrains IDE'lerinde de çalışır.
Uzak MCP destekleyen her istemci yalnızca şu üç değere ihtiyaç duyar:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
İstemcin yalnızca yerel MCP sunucularını destekliyorsa, Claude Desktop sekmesinde gösterilen npx mcp-remote köprüsünü kullan — yalnızca stdio konuşan her istemciyle çalışır.
AI araçlarının içinde Gender-API’yi doğrudan kullan
MCP Server çözümümüz, MCP uyumlu yapay zekâ araçlarının Gender-API’yi doğrudan çağırmasını sağlar. Böylece asistanın, sadece prompt talimatlarına güvenmek yerine yapılandırılmış araç çağrılarıyla; adları, tam adları, e-postadan türetilen adları ve menşe ülke verilerini zenginleştirebilir.
Kurulacak ya da barındırılacak bir şey yok: aracını https://mcp.gender-api.com adresine yönlendir ve API için hâlihazırda kullandığın Gender-API token'ıyla kimlik doğrula.
Müşterilerin bununla neler yapabileceği
- Canlı Gender-API verilerini kullan: Yapay zekâ aracın, istek formatları ya da yanıtlar uydurmak yerine canlı Gender-API sonuçlarını sorgulayabilir.
- Mevcut token’ını tekrar kullan: MCP sunucusu, API için zaten kullandığın Gender-API bearer token’ı ile aynı şekilde çalışır.
- MCP uyumlu istemcileri bağla: Claude, Cursor ya da barındırılan MCP URL’lerini destekleyen kendi MCP uyumlu dahili araçların ve ajanlarınla kullanabilirsin.
- Faturalandırmayı basit tut: Normal Gender-API kredi kullanımı aynen geçerli olmaya devam eder; yani öğrenmen gereken ikinci bir faturalandırma sistemi yok.
Desteklenen araçlar
Dahil edilen MCP araçları
- query_first_name – İlk isme göre olası cinsiyeti sorgula.
- query_full_name – Tam ad üzerinden muhtemel gender sorgula.
- query_email – Bir e-posta adresinden isim çıkar ve zenginleştir.
- get_country_of_origin – Muhtemel köken ülkelerini öğren.
- get_statistics – Kalan kredilerini ve hesap istatistiklerini kontrol et.
Hosted transport;;Barındırılan taşıma
Barındırılan Streamable HTTP uç noktasını https://mcp.gender-api.com adresinde kullan ve mevcut Gender-API bearer token'ınla kimlik doğrula.
Gerçek dünyadan MCP kullanım örnekleri
Yapay zeka copilotu içinde lead zenginleştirme
Claude, Cursor ya da şirket içi bir satış temsilcisi bir potansiyel müşteri listesini inceleyebilsin; MCP üzerinden Gender-API’yi çağırıp, iletişime geçmeden önce olası adları, gender bilgisini ve ülke kökeni bağlamını eklesin.
CRM ve destek kişiselleştirmesi
Destek asistanın gelen e-posta adreslerini inceleyebilir, `query_email` ile muhtemel adları çıkarabilir ve temsilciler için daha doğal, kişiselleştirilmiş taslak yanıtlar oluşturabilir.
E-tablo temizliği ve araştırma ajanları
MCP özellikli veri temizleme ajanları, CSV dosyalarını veya e-tabloları inceleyebilir; ad sütunlarını standart hale getirebilir ve her iş akışında özel API kodu yazmana gerek kalmadan satırları Gender-API sonuçlarıyla zenginleştirebilir.
Pazarlama otomasyonu ve segmentasyon
Kampanya oluşturma asistanlarında MCP’yi kullanarak selamlamalar oluştur, iletişim verilerini zenginleştir ve bir kişiselleştirme iş akışını başlatmadan önce kalan kredilerini kontrol et.
Kendi MCP istemcini mi geliştiriyorsun?
Resmi MCP SDK ile bağlan
Hazır bir araç kullanmak yerine kendi ajanını yazıyorsan, Streamable HTTP taşımasını doğrudan bağla:
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',
},
},
});
Sıkça Sorulan Sorular
Bu, normal Gender-API kredilerimi kullanır mı?
Evet. MCP sunucusu, mevcut Gender-API uç noktalarının üzerinde yer alan ince bir entegrasyon katmanıdır; bu yüzden normal token izinleri ve kredi kullanımı aynen geçerlidir.
Kendi dahili MCP aracımda kullanabilir miyim?
Evet. Aracın barındırılan MCP'yi destekliyorsa onu https://mcp.gender-api.com adresine bağla ve Gender-API bearer token'ını gönder.
Bir şey kurmam gerekiyor mu?
Hayır. MCP sunucusunu biz barındırıyoruz, dolayısıyla indirilecek ya da sürekli çalışır tutulacak bir şey yok. Yalnızca yerel MCP sunucularını destekleyen istemciler, ilk açılışta kendini indiren npx mcp-remote köprüsünü kullanır.
AI aracım Gender-API araçlarını göstermiyor. Şimdi ne olacak?
Yapılandırmayı düzenledikten sonra aracı yeniden başlat ve token yer tutucusunu gerçek API token'ınla değiştirdiğini bir daha kontrol et. Bağlantı reddediliyorsa token'ın geçersiz ya da kredisi bitmiş demektir — ikisi de kimlik doğrulama hatası olarak görünür.
Herhangi bir sorunuz var mı?
