ホスト型MCPサーバー
1分でセットアップ
- アカウント設定からAPIトークンをコピーします。
- 下から使っているツールを選び、スニペットを貼り付けて、トークンのプレースホルダーを自分のトークンに置き換えます。
- AIツールを再起動して、「イタリアでAndreaという名前はどちらの性別の可能性が高い?」のように質問してみてください
ターミナルでこのコマンドを1回実行するだけ — これでセットアップは完了です。
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
現在のプロジェクトだけでなく、すべてのプロジェクトでGender-APIを使えるようにするには --scope user を追加してください。
Claude Desktopは自動的にダウンロードされる小さなnpmブリッジ経由で接続します。これを設定ファイルに追加してください — 手動インストールは不要です。
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
設定ファイルの場所:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Authorization:Bearer はコロンの後にスペースを入れずに書いてください — ブリッジはこの形を期待します。
すべてのプロジェクトで使うなら ~/.cursor/mcp.json に、単一のプロジェクトだけなら .cursor/mcp.json に追加してください。
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
プロジェクト内の .vscode/mcp.json に追加するか、どこでも有効にするならユーザーレベルの mcp.json に追加してください。
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Codeは mcpServers ではなく servers を使い、ヘッダーは requestInit の中に置きます。同じ構造がVisual StudioやJetBrains製IDEでも使えます。
リモートMCPに対応したクライアントなら、必要なのはこの3つの値だけです:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
クライアントがローカルMCPサーバーしか対応していない場合は、Claude Desktopタブに載っている npx mcp-remote ブリッジを使ってください — stdioのみのクライアントでも動きます。
AIツール内でGender-APIを直接使用する
当社の MCP Server を使用すると、MCP互換のAIツールがGender-APIを直接呼び出すことができます。つまり、アシスタントはプロンプトのみの指示ではなく、構造化されたツール呼び出しを通じて、名前、フルネーム、メールアドレスから派生した名前、および原国データをエンリッチできます。
インストールするものもホスティングするものもありません: ツールを https://mcp.gender-api.com に向けて、APIで既に使っているGender-APIトークンで認証するだけです。
お客様ができること
- リアルタイムのGender-APIデータを使用する: お客様のAIツールは、リクエスト形式やレスポンスを捏造する代わりに、リアルタイムのGender-APIの結果を照会できます。
- 既存のトークンを再利用する: MCPサーバーは、既存のAPIで使用しているものと同じGender-APIベアラートークンで動作します。
- MCP互換クライアントを接続する: Claude、Cursor、またはホストされたMCP URLをサポートする独自のMCP互換の内部ツールやエージェントで使用できます。
- 請求をシンプルに維持する: 通常のGender-APIクレジット使用量が引き続き適用されるため、新しい請求システムを学習する必要はありません。
サポートされているツール
含まれているMCPツール
- query_first_name – 名前(ファーストネーム)から推定される性別を照会します。
- query_full_name – フルネームから推定される性別を照会します。
- query_email – メールアドレスから名前を抽出して情報を拡充します。
- get_country_of_origin – 推定される出身国を取得します。
- get_statistics – 残りのクレジットとアカウントの統計を確認します。
ホストされたトランスポート
ホスト型の Streamable HTTP エンドポイント https://mcp.gender-api.com を使い、既存のGender-APIベアラートークンで認証します。
実世界のMCPユースケース
AIコパイロット内でのリード拡充
Claude、Cursor、または内部のセールスエージェントにリードリストを確認させ、MCP経由でGender-APIを呼び出し、アウトリーチの前に推定される名前、性別、および出身国のコンテキストを追加させることができます。
CRMとサポートのパーソナライゼーション
お客様のサポートアシスタントは、受信したメールアドレスを検査し、`query_email` を使用して可能性の高い名前を抽出して、エージェントがより自然でパーソナライズされた返信の下書きを作成できるようにします。
スプレッドシートのクリーンアップおよびリサーチエージェント
MCP対応のデータクリーニングエージェントは、CSVファイルやスプレッドシートを確認し、名(first-name)の列を標準化し、各ワークフローにカスタムAPIコードを記述することなく、Gender-APIの結果を使用して行のデータを拡充できます。
マーケティングオートメーションとセグメンテーション
パーソナライゼーション・ワークフローを開始する前に、キャンペーン構築アシスタントでMCPを使用して、挨拶文の生成、連絡先データの拡充、および残りのクレジットの確認を行ってください。
独自のMCPクライアントを開発中ですか?
公式MCP SDKで接続する
既製のツールを使わず自分でエージェントを書く場合は、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',
},
},
});
よくある質問
これは通常のGender-APIクレジットを使用しますか?
はい。MCPサーバーは既存のGender-APIエンドポイント上の軽量な統合レイヤーであるため、通常のトークン権限とクレジットの使用状況が引き続き適用されます。
自身の内部MCPツールで使用できますか?
はい。ツールがホスト型MCPに対応していれば、https://mcp.gender-api.com に接続してGender-APIベアラートークンを送ってください。
何かインストールする必要はありますか?
いりません。MCPサーバーは当社がホストしているので、ダウンロードするものも動かし続けるものもありません。ローカルMCPサーバーのみ対応のクライアントは npx mcp-remote ブリッジを使い、これは初回起動時に自動でダウンロードされます。
AIツールにGender-APIのツールが表示されません。どうすれば?
設定を編集したらツールを再起動し、トークンのプレースホルダーを実際のAPIトークンに置き換えたかもう一度確認してください。接続が拒否される場合は、トークンが無効かクレジットが不足しています — どちらも認証エラーとして表示されます。