利用可能対象
-
すべての Phrase プランで、現在追加費用なしで利用可能
Phrase MCP サーバー (Model Context Protocol サーバー) は、Claude などの AI アシスタントを Phrase に接続します。これにより、Phrase の言語インテリジェンスがこれらのツールにもたらされ、アシスタントが自然言語を使用してプロジェクト、ジョブ、翻訳を扱えるようになります。このサーバーは Phrase TMS、Phrase Strings、および API を通じて公開されるその他の Phrase 機能にまたがっており、いずれかの製品内ではなく、それらの個別の製品の上位で動作します。
機能
MCP サーバーは、Phrase の言語インテリジェンスを既に使用中の AI ツールにもたらし、仕事がどこで行われていても、自然言語でコンテンツ、ジョブ、翻訳に対してアクションを実行できるようにします。一般的なタスクは以下の通りです。
-
プロジェクトやジョブに関する質問をする。
-
個別のファイルや言語を開くことなく、コンテンツ全体の品質問題をトラブルシューティングする。
-
ジョブの作成やプロジェクトの再割り当て。
-
一度に1項目ずつ更新するのではなく、一括更新を実行する。
接続オプション
MCP サーバーは2つの接続方法をサポートしています。
Remote 接続 (推奨)
Remote 接続は既存の Phrase アカウントでのサインインを使用し、インストールは不要です。この方法は、Remote サーバーへの接続をサポートする AI ツールで機能します。
Remote 接続は OAuth を使用して認証を行います。これは、この方法で現在サポートされている唯一の認証プロトコルです。ベアラートークンや API キーなど、手動のヘッダーベースの認証を必要とするカスタムまたはサードパーティのワークフロー ツールは、現在 Remote 接続ではサポートされていません。
VS Code での古い認証
Visual Studio Code (VS Code) は、MCP サーバーに登録されたクライアント ID を、表示名ではなくサーバー URL をキーとしてキャッシュします。そのクライアント ID が Phrase サーバー上に存在しなくなった場合、VS Code は新しい登録をトリガーする代わりに、古い ID を送信し続けます。その結果、期待される同意画面ではなく、一致しない client_id と redirect_uri を報告する 400 Bad Request エラーが発生します。mcp.json 内のサーバーエントリーを削除して再インストールしたり、名前を変更したりしても、キャッシュはサーバー URL をキーとしているため、キャッシュされた登録はクリアされません。
VS Code 1.101 以降でこの問題を解決するには、次の手順に従ってください。
-
コマンドパレット (Ctrl/Cmd+Shift+P) を開き、Authentication: Remove Dynamic Authentication Providers を実行してから、Phrase MCP サーバーエントリーを選択します。
-
メニューを開き、Phrase MCP サーバーに関連付けられているアカウントを見つけて Manage Trusted MCP Servers を開き、取り消すか、そのアカウントエントリーからサインアウトします。
-
MCP ビュー、または MCP: List Servers を介して、サーバー接続を停止して再起動するか、Developer: Reload Window を実行します。
次のツール呼び出しで新しい登録がトリガーされ、同意画面が表示されます。
備考
これらの手順で古い登録がクリアされない場合は、オペレーティングシステム (OS) の資格情報ストア (macOS キーチェーン、Windows 資格情報マネージャー、または Linux の libsecret) および VS Code のグローバルストレージから、保存された認証を個別にクリアしてください。これにより、設定されている他のすべての MCP サーバーの認証がクリアされます。
セルフホスト接続 (非推奨)
セルフホスト接続はチームが管理するインフラストラクチャ上で実行され、Node.js と設定ファイルが必要です。
セットアップの開始
さまざまな AI ツール用のコマンドを含む、両方の接続オプションの完全なセットアップ手順については、Developer Hub の記事「Phrase MCP サーバー」を参照してください。
接続後、Developer Hub の記事「Server Starter Prompts」で、タスクごとに整理されたスタータープロンプトの一覧を確認できます。
権限
接続時に、アカウント所有者はアシスタントに付与するアクセスレベル(データの表示、データの作成、またはデータの変更と削除)を選択します。これは既存の Phrase ロール権限に加えて適用されるものであり、置き換わるものではないため、アシスタントがアカウントで許可されている範囲を超えることはできません。
アクセス権の確認や取り消しは、いつでも Phrase プロファイル設定の タブから行えます。