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 サーバー自身が 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