利用可能対象
-
すべてのPhraseプランで、現在は追加費用なしでご利用いただけます。
Phrase MCPサーバー(Model Context Protocol Server)は、ClaudeなどのAIアシスタントをPhraseに接続します。これにより、Phraseの言語インテリジェンスがこれらのツールにもたらされ、アシスタントが自然言語を使用してプロジェクト、ジョブ、翻訳を操作できるようになります。このサーバーはPhrase TMS、Phrase Strings、およびAPIを通じて公開されるその他のPhrase機能にまたがっており、個々の製品内ではなく、それらの製品の上位で動作します。
機能
MCPサーバーは、Phraseの言語インテリジェンスを既に使用しているAIツールにもたらし、作業場所を問わず、自然言語でコンテンツ、ジョブ、翻訳を操作できるようにします。一般的なタスクは以下の通りです。
-
プロジェクトやジョブに関する質問をする。
-
個別のファイルや言語を開くことなく、コンテンツ全体の品質問題をトラブルシューティングする。
-
ジョブの作成やプロジェクトの再割り当てを行う。
-
一度に1項目ずつ更新するのではなく、一括更新を実行する。
-
Phrase TMSコネクタの作成、編集、削除
接続オプション
MCPサーバーは2つの接続方法をサポートしています。
Remote接続(推奨)
Remote接続は既存のPhraseアカウントでのサインインを使用するため、インストールは不要です。この方法は、リモートサーバーへの接続をサポートするAIツールで機能します。
リモート接続はOAuthを使用して認証を行います。これは、現在この方法でサポートされている唯一の認証プロトコルです。手動のヘッダーベース認証を必要とするカスタムワークフローツールやサードパーティ製ワークフローツールは、現在リモート接続ではサポートされていません。これには、ベアラートークン、APIキー、マシン間(M2M)認証情報が含まれます。
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:を実行します。動的認証プロバイダーを削除してから、Phrase MCPサーバーエントリを選択します。
-
メニューを開き、Phraseサーバーに関連付けられているアカウントを見つけて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 Server」をご覧ください。
接続後、タスク別に整理されたスタータープロンプトの厳選リストについては、Developer Hubの記事「Server Starter Prompts」をご覧ください。
権限
接続時に、アカウント所有者はアシスタントに付与するアクセスレベル(データの表示、データの作成、またはデータの変更と削除)を選択します。これは既存のPhraseロール権限に加えて適用されるものであり、置き換わるものではありません。そのため、アシスタントがアカウントで許可されている範囲を超えることはできません。
Phraseのプロフィール設定にあるタブから、いつでもアクセスを確認または取り消すことができます。