Gender API
無料でサインアップ
言語 expand_more

ホスト型MCPサーバー

Gender-API ホスト型MCPサーバー統合
ホスト型MCPエンドポイント

1分でセットアップ

  1. アカウント設定からAPIトークンをコピーします。
  2. 下から使っているツールを選び、スニペットを貼り付けて、トークンのプレースホルダーを自分のトークンに置き換えます。
  3. 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',
    },
  },
});

よくある質問

01

これは通常のGender-APIクレジットを使用しますか?

はい。MCPサーバーは既存のGender-APIエンドポイント上の軽量な統合レイヤーであるため、通常のトークン権限とクレジットの使用状況が引き続き適用されます。

02

自身の内部MCPツールで使用できますか?

はい。ツールがホスト型MCPに対応していれば、https://mcp.gender-api.com に接続してGender-APIベアラートークンを送ってください。

03

何かインストールする必要はありますか?

いりません。MCPサーバーは当社がホストしているので、ダウンロードするものも動かし続けるものもありません。ローカルMCPサーバーのみ対応のクライアントは npx mcp-remote ブリッジを使い、これは初回起動時に自動でダウンロードされます。

04

AIツールにGender-APIのツールが表示されません。どうすれば?

設定を編集したらツールを再起動し、トークンのプレースホルダーを実際のAPIトークンに置き換えたかもう一度確認してください。接続が拒否される場合は、トークンが無効かクレジットが不足しています — どちらも認証エラーとして表示されます。

なにか質問ある?

Chat