Gologin MCP Server

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を開き、クイックスタート設定をclaude_desktop_config.jsonに追加します。Claude Desktopを完全に終了して再起動し、gologin-mcpとそのツールが利用可能であることを確認します。

設定パスとトラブルシューティングについては、公式ローカルMCPセットアップガイドを参照してください。

Cursor

ユーザーアカウントの~/.cursor/mcp.json、またはプロジェクトの.cursor/mcp.jsonにクイックスタート設定を追加します。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パッケージを最初に公開し、次にリポジトリのActionsタブのmainからPublish to MCP Registryを実行します。ワークフローは、npmリリースに正しいレジストリ識別子が含まれていることを検証し、GitHub OIDCを使用して認証します。個別のレジストリトークンは不要です。npmへの公開は行いません。

リンク

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

ライセンス

MIT、著作権 GoLogin。