MCPサーバー (統合)

利用可能対象

Phrase MCPサーバー (Model Context Protocolサーバー) は、ClaudeなどのAIアシスタントをPhraseに接続します。これにより、Phraseの言語インテリジェンスがこれらのツールにもたらされ、アシスタントが自然言語を使用してプロジェクト、ジョブ、翻訳を扱えるようになります。このサーバーはPhrase TMS、Phrase Strings、およびAPIを通じて公開されるその他のPhrase機能にまたがっており、いずれかの製品内ではなく、それらの個別の製品の上位で動作します。

機能

MCPサーバーは、Phraseの言語インテリジェンスを現在使用中のAIツールにもたらし、仕事がどこで行われていても、自然言語でコンテンツ、ジョブ、翻訳を操作できるようにします。一般的なタスクは以下の通りです。

接続オプション

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 以降でこの問題を解決するには、以下の手順に従ってください。

次のツール呼び出しで新しい登録がトリガーされ、同意画面が表示されます。

セルフホスト接続 (非推奨)

セルフホスト接続は Team が管理するインフラストラクチャ上で実行され、Node.js と設定ファイルが必要です。

セットアップの開始

さまざまな AI ツール用のコマンドを含む、両方の接続オプションの完全なセットアップ手順については、Developer Hub の記事「Phrase サーバー」を参照してください。

接続後、Developer Hub の記事「Server Starter Prompts」で、タスク別に整理された Starter プロンプトの一覧を確認できます。

権限

接続時に、アカウント所有者はアシスタントに付与するアクセスレベル（データの表示、データの作成、またはデータの変更と削除）を選択します。これは既存の Phrase ロール権限に追加して適用されるものであり、置き換わるものではないため、アシスタントがアカウントで許可されている範囲を超えることはできません。

アクセス権の確認や取り消しは、いつでも Phrase プロファイル設定の Consents タブから行えます。

関連記事