Title: Claude から TeamPage に接続する(サーバーが社内限定の場合)
Claude デスクトップアプリから、社内ネットワークにある TeamPage サーバーの記事を読み書きできるようにする手順を説明します。
TeamPage サーバーをインターネットに公開する必要はありません。ファイアウォールの内側にあるサーバーや、VPN 接続でのみ到達できるサーバーでも利用できます。
この記事では、Windows 環境での手順を説明します。
仕組み
Claude には、外部のシステムと連携するための MCP (Model Context Protocol) という仕組みがあります。
通常の接続方法では、Anthropic 社のサーバーからお客様の TeamPage サーバーへ接続します。この方法は簡単ですが、TeamPage サーバーがインターネットに公開されている必要があります。
この記事で説明する方法では、利用者のパソコンの中で「mcp-remote」という小さなプログラムを動かします。Claude デスクトップアプリはこのプログラムと会話し、プログラムが TeamPage サーバーへ接続します。
[パソコン]
Claude デスクトップアプリ
↕
mcp-remote ──────▶ TeamPage サーバー(社内)
TeamPage サーバーへの通信は、利用者のパソコンから発信されます。 社内ネットワークまたは VPN 接続済みであれば到達できるため、サーバーを公開する必要がありません。記事の内容が Anthropic 社のサーバーを経由することもありません。
Solr 高機能検索の有無による違い
Claude が TeamPage に対してできることは、TeamPage の「Solr 高機能検索」が有効かどうかで変わります。
Solr 高機能検索が無効の場合でもできること
記事 ID を指定して記事を取得する操作は、検索機能を使わないため利用できます。
Test1 の内容を要約して
Test1 と Test2 の違いを説明して
Solr 高機能検索が有効な場合にできること
キーワードや内容に基づいて記事を探す操作が利用できます。
製品 XYZ の不適合について、Foo さんと Bar さんと Buz さんが議論している議事録を探して
先月の障害報告をまとめて
こうした「どこに書いてあるか分からないものを探す」使い方が、Claude 連携の利点を最も活かせる場面です。Solr 高機能検索を有効にすることをお勧めします。
Solr 高機能検索の設定については、FAQ1956: Solr 高機能検索 をご覧ください。
前提条件
TeamPage サーバー側
- TeamPage 7.1 以降
- com.traction.mcp および com.traction.oauth.server プラグインが有効であること
- キーワード検索を利用する場合は、Solr 検索が有効であること
- 利用者のパソコンから、ブラウザーでアクセスできること
利用者のパソコン側
- Windows または macOS
- 社内ネットワークに接続、または VPN 接続ができること
- Node.js 18 以降をインストールできること
- Claude デスクトップアプリをインストールできること
- Claude の有料プラン
サーバーの構成についてのご注意
TeamPage サーバー自身が HTTPS を終端している構成(サーバー設定のセキュリティ レベルが「あり」)では、記事の取得や検索が失敗する既知の問題があります。
リバース プロキシ (Apache や ロード バランサーなど) で HTTPS を終端し、TeamPage 自身は HTTP で動作させる構成をご利用ください。設定手順は FAQ309: Apache を使って TeamPage を HTTPS で運用する をご覧ください。
手順
以下、TeamPage サーバーの URL を https://winvm.local として説明します。実際の URL に読み替えてください。
Node.js のインストール
Node.js の公式サイト から LTS 版をダウンロードし、インストールします。
インストール後、コマンド プロンプトまたは PowerShell を開いて、次のコマンドでバージョンを確認します。
node --version
v18 以降が表示されれば問題ありません。
Claude デスクトップアプリのインストール
Claude のダウンロード ページ からデスクトップアプリをダウンロードし、インストールします。
インストール後、一度起動して Claude アカウントでログインしておきます。
設定ファイルの作成
1. 既定のブラウザーを Chrome にします
後の認証手順でブラウザーが自動的に開きます。Windows Server 環境では既定が Microsoft Edge になっていることが多く、「Internet Explorer セキュリティ強化の構成」が有効だとログインできません。
設定 → アプリ → 既定のアプリ から Chrome を選択してください。
2. npx の場所を確認します
PowerShell で次のコマンドを実行します。
Get-Command npx | Select-Object -ExpandProperty Source
表示されたパスを次の手順で使用します。通常は C:\Program Files\nodejs\npx.cmd です。
3. 設定ファイルを編集します
Claude デスクトップアプリの 設定 → 開発者 → 構成を編集 をクリックすると、設定ファイルの場所が開きます。
claude_desktop_config.json をテキスト エディタで開き、次の内容を記述します。
{
"mcpServers": {
"teampage": {
"command": "C:\\Program Files\\nodejs\\npx.cmd",
"args": [
"-y",
"mcp-remote",
"https://winvm.local/traction/mcp",
"41316",
"--transport", "http-only"
]
}
}
}
各項目の意味は次の通りです。
| 項目 |
説明 |
command |
手順 2 で確認した npx のパス。円記号は 2 つ重ねて記述します |
| URL |
TeamPage の URL の末尾に /traction/mcp を付けたもの |
41316 |
認証時に使用するポート番号。必ず指定してください(後述) |
--transport http-only |
接続方式の指定 |
自己署名証明書を使用している場合
TeamPage が自己署名証明書を使用している場合、そのままでは接続できません。証明書を Windows の「信頼されたルート証明機関」にインストールしてください(手順は FAQ309: Apache を使って TeamPage を HTTPS で運用する の「クライアント側で証明書をインストール」をご覧ください)。
TeamPage を HTTP で運用している場合
URL が http:// で始まる場合は、args に "--allow-http" を追加してください。
{
"mcpServers": {
"teampage": {
"command": "C:\\Program Files\\nodejs\\npx.cmd",
"args": [
"-y",
"mcp-remote",
"https://winvm.local/traction/mcp",
"41316",
"--transport", "http-only",
"--allow-http"
]
}
}
}
初回の認証
1. Claude デスクトップアプリを完全に終了します
ウィンドウを閉じるだけではタスク トレイに常駐したままになります。タスク トレイのアイコンを右クリックして「Quit」を選択してください。
2. Chrome で TeamPage にログインしておきます
https://winvm.local/ を開いてログインした状態にしておくと、次の手順がスムーズです。
3. Claude デスクトップアプリを起動します
起動すると Chrome が自動的に開き、TeamPage の認証画面が表示されます。内容を確認して承認してください。
承認が完了すると、認証情報がパソコン内に保存されます。次回以降は自動的に接続されます。
動作確認
接続されているかを確認するには、チャット入力欄の下にある「+」ボタンをクリックし、「コネクタ」を選択します。一覧に teampage が表示されていれば接続されています。
または、Claude デスクトップアプリの 設定 → 開発者 から、接続状態を確認することもできます。
続いて、実際に記事が取得できるかを試します。Claude に次のように話しかけてください。
TeamPage の Test1 という記事を読んで内容を教えて
Test1 の部分は、お客様の TeamPage に実在する記事の 記事 ID に置き換えてください。記事 ID は記事を開いたときに表示される ABC123 のような識別子です。
記事の内容が返ってくれば成功です。
接続の確認方法は Claude デスクトップアプリのバージョンによって異なります。詳しくは Anthropic のヘルプ をご覧ください。
最も確実な確認方法は、実際に Claude に記事の取得を依頼してみることです。
トラブルシューティング
ログイン画面が繰り返し表示され、ログインできない
ユーザー名やパスワードの誤りを示すメッセージも出ずに、画面が再読み込みされる場合は、次の 2 点を確認してください。
開いたブラウザーが Chrome 以外の場合
Microsoft Edge や Internet Explorer が開いている場合、「Internet Explorer セキュリティ強化の構成」が Cookie を保存できなくしている可能性があります。既定のブラウザーを Chrome に変更してください。
サーバーの構成を HTTPS から HTTP に変更した場合
以前に保存された Cookie が新しい Cookie の保存を妨げていることがあります。Chrome のアドレス バーに chrome://settings/content/all と入力し、サーバー名で検索して該当する Cookie を削除してください。
ツールの一覧に teampage が表示されない
Claude デスクトップアプリのログを確認します。
Get-Content "$env:APPDATA\Claude\logs\mcp-server-teampage.log" -Tail 50
ECONNREFUSED と表示される場合
TeamPage サーバーが起動していないか、まだ起動処理中です。TeamPage が完全に起動したことを確認してから、Claude デスクトップアプリを再起動してください。
EADDRINUSE と表示される場合
設定ファイルで指定したポート番号が他のプログラムに使用されています。Claude デスクトップアプリを完全に終了し、次のコマンドで確認してください。
netstat -ano | Select-String ":41316"
何か表示される場合は、そのプログラムを終了させるか、設定ファイルのポート番号を別の値(例: 41317)に変更してください。
記事の取得や検索が失敗する
TeamPage サーバー自身が HTTPS を終端している構成の場合、既知の問題により失敗します。「前提条件」の注意事項をご覧ください。
認証をやり直したい
保存されている認証情報を削除して、Claude デスクトップアプリを再起動すると、認証画面が再度表示されます。
Remove-Item -Recurse -Force $env:USERPROFILE\.mcp-auth
制限事項
Claude デスクトップアプリでのみ利用できます
この方法は利用者のパソコン内でプログラムを動かすため、Web 版やモバイル版の Claude では利用できません。
定期的に再認証が必要です
認証情報の有効期限は 7 日間です。期限が切れると、次回接続時にブラウザーでの認証が再度必要になります。
パソコンごとに設定が必要です
複数のパソコンで利用する場合、それぞれで設定と認証を行う必要があります。
TeamPage 上の権限が適用されます
Claude が読み書きできる範囲は、認証したユーザーの TeamPage 上の権限と同じです。閲覧権限のないスペースの記事は取得できません。
技術情報:TeamPage 側の HTTPS 構成について
TeamPage サーバー自身が HTTPS を終端する構成(サーバー設定 → ネットワーク → HTTP サーバー の「セキュリティ レベル」が「あり」)の場合、Claude との接続は確立し、ツールの一覧までは取得できますが、記事の取得や検索を実行すると失敗します。
これは MCP プラグインの内部処理に起因するもので、現在調査・対応中です。
回避方法
リバース プロキシ (Apache やロード バランサーなど) で HTTPS を終端し、TeamPage 自身は HTTP で動作させる構成をご利用ください。
セキュリティ レベル:なし
ポート:8080 など
サーバー名:https:// から始まる、ユーザーがアクセスする URL
設定手順は FAQ309: Apache を使って TeamPage を HTTPS で運用する をご覧ください。
クラウド環境でロード バランサーを経由している場合は、多くの場合この構成になっているため、そのままご利用いただけます。
関連記事
FAQ-A: TeamPage の Claude 連携 (MCP) を利用するための準備
FAQ-B: Claude から TeamPage に接続する(サーバーが外部公開されている場合)
FAQ309: Apache を使って TeamPage を HTTPS で運用する
Article: FAQ2962 (
permalink)
Categories: :FAQ:AI, :DocJp:FAQ, :DocJp:AI, :FAQ:Claude
Date: 2026/07/29; 19時34分20秒 JST
Author Name: TeamPage サポート
Author ID: jpbo