| 項目 | 内容 | 備考 |
|---|---|---|
| TeamPage | 7.1.07 以降。インターネットから HTTPS で接続できること | 有効な SSL 証明書が必要です(自己署名証明書は不可) |
| TeamPage ユーザー | Claude から使うユーザー名とパスワード | Claude はこのユーザーの権限の範囲で記事を読み書きします |
| Claude のアカウント | Free / Pro / Team / Enterprise | プランによる違いは「よくある質問」を参照 |
| Claude Desktop | Windows 版または Mac 版の最新版 | 追加したコネクタは、同じアカウントのブラウザー版 claude.ai でも使えます |
| Web ブラウザー | Chrome または Edge など | TeamPage へのログイン(認可)に使います |
https://win.teampage.jp/ とします。https://<サーバー名>/.well-known/oauth-protected-resource/traction/mcp"resource":"https://<サーバー名>/traction/mcp" を含む JSON が表示されれば OK です。https://<サーバー名>/traction/mcp が、手順 3 で入力する接続先 URL になります。https:// ではなく http:// になっている場合や、サーバー名が内部の名前になっている場合は、リバースプロキシーの設定 (X-Forwarded-Proto / X-Forwarded-Host) を見直してください。このままでは手順 4 のログインが失敗します。https://win.teampage.jp/traction/mcp)/traction/mcp です。https://<サーバー名>/ だけを入力しても接続できません。| ツールの種類 | 例 | おすすめの設定 |
|---|---|---|
| 読み取り(検索・取得) | query_teampage、get_teampage_entry_by_tractionid、list_teampage_projects |
常に許可 |
| 書き込み(作成・編集) | create_teampage_entry、create_teampage_comment、update_teampage_entry |
使うたびに確認 |
| 削除 | erase_teampage_entry |
使うたびに確認、または無効 |
| 症状 | 原因 | 対処 |
|---|---|---|
| 「連携させる」をクリックすると、ブラウザーが開かずにエラーになる | Anthropic 社のサーバーから TeamPage に到達できない、または URL が誤っている | 手順 1 の URL を確認する。接続元 IP を制限している場合は、Anthropic 社の送信元 IP アドレスを許可する |
| ログイン後にエラー画面が表示され、連携できない | リバースプロキシーの設定不足(X-Forwarded-Proto / X-Forwarded-Host、ProxyErrorOverride など) | FAQ2774: Apache を使って TeamPage をリバース プロキシ構成で運用する (HTTP) と FAQ309: Apache を使って TeamPage を HTTPS で運用する の設定を確認する |
| 「Claude.app を開きますか?」が表示されない | ブラウザーが外部アプリの起動をブロックしている | ブラウザーで許可する。または Claude Desktop に手動で戻り、コネクタが連携済みか確認する |
| しばらくすると、再びログインを求められる | ログイン情報(トークン)の有効期限(7 日)が切れた | コネクタの「連携させる」からログインし直す |
| 記事が見つからない、または作成できない | 連携した TeamPage ユーザーに権限がない | TeamPage の権限設定を確認する。別のユーザーで連携し直す場合は、コネクタを切断してから手順 4 をやり直す |
| 検索でエラーになる(他の操作はできる) | TeamPage の高機能検索サービス(Solr)が停止している | Solr を起動し、必要に応じて再インデックスする |
add_custom_connector_1.png
add_custom_connector_2.png
add_custom_connector_3.png
add_custom_connector_4.png
add_custom_connector_5.png
add_custom_connector_6.png
claude_example1.png
image.png