GoLogin MCP

AI エージェント向け GoLogin MCP サーバー

AI との会話を通じて、GoLogin のブラウザープロファイル、プロキシ、フィンガープリント、フォルダー、クラウドブラウザーセッションを管理します。この Model Context Protocol（MCP）サーバーは、AI クライアントを GoLogin API に接続します。

クイックスタート

Node.js 22 以降、有効な GoLogin アカウント、GoLogin API トークンが必要です。Node.js 22 および 24 LTS は、macOS Apple Silicon でテスト済みです。

1. GoLogin アカウントにサインインし、API & MCP を開いて、API タブでトークンを生成します。
2. トークンのプレースホルダーを置き換えて、この設定を MCP クライアントに追加します。既存の mcpServers 設定がある場合は、その中に統合してください。

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. クライアントの MCP 接続を再起動または再読み込みしてから、**「GoLogin のプロファイルを表示して」**と尋ねます。

クライアントがサーバーを自動的に起動します。-y を指定すると、npm が対話形式の確認なしでパッケージをインストールします。このサーバーが読み取るのは API_TOKEN です。他の GoLogin CLI で使用される GOLOGIN_TOKEN 変数は、ここでは別名として扱われません。

ターミナルで起動を確認するには、環境変数に API_TOKEN が設定済みの状態で、次を実行します。

npx -y gologin-mcp

サーバーは標準入力／出力（stdio）を介して通信し、MCP クライアントからの接続を待ちます。単独でブラウザーを開いたり、対話型のコマンドプロンプトを提供したりすることはありません。

できること

• ブラウザープロファイルの作成、読み取り、更新、削除、整理。
• プロファイルのプロキシ設定とブラウザーフィンガープリントの更新。
• フォルダーと、そのフォルダーに属するプロファイルの管理。
• アカウント情報の読み取り。
• GoLogin クラウドでのブラウザープロファイルの起動と停止。

クラウドでの起動時に接続 URL が返されます。このサーバーには、ページの移動、クリック、フォーム入力、ローカルの Orbita 起動を行うツールはありません。ページを自動化するには、別のブラウザー自動化クライアント、または GoLogin Agent Browser CLI を使用してください。

MCP プロセスはローカルで実行されます。GoLogin API リクエストとクラウドブラウザーセッションには、ネットワークアクセスが必要です。クラウドの利用可否と API 操作は、アカウントの権限とプランによって異なります。

ツール

ツール名は、サーバーが起動時に読み込む GoLogin OpenAPI 仕様の HTTP メソッドとパスから生成されます。以下は利用可能なツールの一部であり、固定されたエイリアス一覧ではありません。現在の名前と入力スキーマは、MCP クライアントで tools/list を照会して確認してください。

ツール	説明
get_profile_v2	ページネーションとフォルダーフィルターを使ってプロファイルを一覧表示、検索
post_profile_custom	名前、OS、プロキシなどの部分的な設定を指定してプロファイルを作成
get_profile_id	ID でプロファイルを読み取り
put_profile_id_custom	選択したプロファイル設定を更新
delete_profile	profilesToDelete に指定したプロファイルを削除
patch_profile_proxy_many_v2	1 つ以上のプロファイルのプロキシを設定
patch_profile_fingerprints	browsersIds に指定したプロファイルのフィンガープリントを更新
get_proxy_v2	プロキシを一覧表示
get_folders	フォルダーを一覧表示
post_folders_folder	名前を指定してフォルダーを作成
patch_folders_folder	フォルダーへのプロファイルの追加または削除
delete_folders_folder	名前を指定してフォルダーを削除
post_profile_id_web	クラウドでプロファイルを起動し、接続 URL を返す
delete_profile_id_web	クラウドプロファイルを停止
get_user	アカウント情報を読み取り

たとえば、MCP クライアントは次の tools/call リクエストを送信して、プロファイルを読み取れます。

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

引数は各ツールの入力スキーマに従います。パスパラメーター、クエリパラメーター、リクエスト本文のフィールドは、トップレベルの引数として渡されます。

プロンプトの例

• 「GoLogin のプロフィールを表示してください。」
• 「'Research' という名前の Linux プロフィールを作成してください。」
• 「プロフィール PROFILE_ID の名前を 'Research US' に変更してください。」
• 「プロフィール PROFILE_ID を、これらのプロキシ設定を使用するように更新してください。」
• 「プロフィール PROFILE_ID のフィンガープリントを更新してください。」
• 「'Research' という名前のフォルダーを作成し、プロフィール PROFILE_ID を追加してください。」
• 「プロフィール PROFILE_ID をクラウドで起動し、接続 URL を教えてください。」
• 「プロフィール PROFILE_ID のクラウドセッションを停止してください。」
• 「GoLogin アカウント情報を表示してください。」

MCP クライアントのセットアップ

Claude Desktop

Settings > Developer > Edit Config を開き、Quickstart の設定を claude_desktop_config.json に追加します。Claude Desktop を完全に終了して再起動し、gologin-mcp とそのツールが利用可能になっていることを確認してください。

設定ファイルの場所とトラブルシューティングについては、公式のローカル MCP セットアップガイドをご覧ください。

Cursor

ユーザーアカウントの場合は ~/.cursor/mcp.json に、プロジェクトの場合は .cursor/mcp.json に Quickstart の設定を追加します。MCP 接続を再読み込みし、サーバーのツールを有効にしてください。API トークンを含む設定は、バージョン管理の対象外にしてください。

現在のクライアント設定については、Cursor の MCP ドキュメントをご覧ください。

その他の MCP クライアント

ローカルの stdio MCP サーバーに対応したクライアントを使用してください。コマンドに npx を、引数に -y と gologin-mcp を設定し、サーバー環境に API_TOKEN を設定します。設定形式と場所はクライアントによって異なります。

トラブルシューティング

• サーバーに接続できない： クライアントから Node.js と npx を利用できることを確認し、MCP 接続を再起動してください。ツール定義を読み込むため、サーバーには docs-download.gologin.com へのアクセスも必要です。
• API が 401 Unauthorized を返す： サーバーに渡した API_TOKEN と、GoLogin でのトークンの有効性を確認してください。変更後は接続を再起動してください。
• ツール名が見つからない： ツール一覧を更新し、tools/list が返す名前を使用してください。list_profiles や start_browser などの名前は、組み込みの別名ではありません。
• クラウドの起動に失敗する： API の応答と、アカウントでクラウドにアクセスできることを確認してください。ローカルの MCP 起動によって、お使いのコンピューターで Orbita が起動するわけではありません。

開発

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

API_TOKEN を設定済みの状態でローカルビルドを実行するには：

node dist/index.js

公開前に、次を実行してください：

npm run release:check

パッケージに含まれるのは、ビルド済みサーバー、パッケージのメタデータ、README、ライセンスのみです。リリースチェックではこの許可リストを検証し、ローカルの状態、データベース、認証情報、開発ファイルが追加ファイルとして含まれないようにします。npm publish は同じチェックを自動的に実行します。

MCP レジストリへのリリース

server.json は、公式 MCP レジストリにおける io.github.gologinapp/gologin-mcp のこのサーバーについて記述しています。npm パッケージでは、同じ識別子を mcpName に指定しています。

package.json、package-lock.json、server.json のバージョンを一致させてください。チェック済みの npm パッケージを先に公開し、その後、main のリポジトリにある Actions タブから Publish to MCP Registry を実行します。このワークフローは、npm リリースに正しいレジストリ識別子が含まれていることを検証し、別途レジストリトークンを使用せずに GitHub OIDC で認証します。npm への公開は行いません。

リンク

• GoLogin
• GoLogin API ドキュメント
• npm パッケージ
• Glama ディレクトリ

ライセンス

MIT、著作権者 GoLogin。