--- title: "ClaudeとPort.ioを接続して、GitHubリポジトリの登録状況を確認してみた" date: 2026-07-07 categories: - "Claude" - "Port.io" url: "https://hidetaka.dev/ja/writing/dev-notes/connect-port-io-mcp-server-from-claude-connector" --- Anthropicのコネクタディレクトリを眺めていたら、Port IOが追加されているのに気づきました。Port.ioはソフトウェアカタログやサービスの依存関係を管理するツールで、業務でも触れる機会があるので、さっそくClaudeから接続できるか試してみました。 ## コネクタディレクトリでPort IOを見つける コネクタの設定画面で「port」と検索すると、Port IOがヒットしました。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/b1f51fcc0a66ef844c9bb94c17c2d142-20260605094324.png) 詳細画面を開くと、ツールは12件、Port.ioのcontext lakeとソフトウェアカタログをClaudeから直接操作できる、という説明が書かれています。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/6e7b500e43b61d60b49cf9631a00697d-20260605094341.png) ## 連携にはPort.io側のサーバーURLが必要 「連携/連携させる」ボタンを押しても、すぐには繋がりませんでした。「インストール Port IO」というモーダルが開き、Port.io側から取得したサーバーURLを自分で貼り付ける必要があります。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/88ade51ebfdbcffd656e7394985df611-20260605094349.png) 他のコネクタだとOAuth認可だけで完結することが多いので、この一手間は少し意外でした。 ## 公式ドキュメントでリージョン別のURLを取得する サーバーURLはPort.ioの公式ドキュメントに掲載されています。[Overview & Installation](https://docs.port.io/ai-interfaces/port-mcp-server/overview-and-installation/?region=us&mcp-setup=claude)のページにEU/USのタブが用意されていて、自分のPortアカウントのリージョンに応じたURLをコピーする仕組みです。リージョンの見分け方は「PortアプリのベースURLに”US”が含まれるかどうか」とドキュメントに書かれています。今回はUSリージョンだったので、次のURLを使いました。 https://mcp.us.port.io/v1 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/f6a29ad31d17d9e998af85551f39cb00-20260605094406.png) ## 取得したURLを貼り付けて認可する 先ほどのモーダルにURLを貼り付けて「続ける」を押します。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/52fba8c0ca22124fb20948def7b86860-20260605094416.png) するとPort.io側のOAuth認可画面に遷移しました。「Claude is requesting access to your Port Production US account」と表示され、プロフィール情報へのアクセスと、オフラインアクセスの許可を求められます。「Accept」を押せば連携完了です。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/7734cb42883ae9e29711039aabc824e1-20260605094424.png) ## 接続完了、ツールの権限を確認する 接続が終わると、コネクタの設定画面にPort IOが表示されました。ここではツールごとに承認モード（自動承認・都度承認・拒否）を選べます。デフォルトは「承認が必要」で、読み取り専用ツールだけで18件表示されていました。ディレクトリのプレビュー画面では12件と書かれていたので、実際に接続してみると表示されるツール数は増えるみたいです。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/eed22768f19b0fc63ace357147c9d4a1-20260605094812.png) ## 実際に使ってみる 接続できたので、実際にPort IOのツールを使ってGitHubリポジトリがPort.ioのソフトウェアカタログに登録されているかを聞いてみました。Claudeはまずblueprintsとリポジトリエンティティを並行して確認し、`list entities`ツールを使って`service` blueprintの中からidentifierまたはtitleに「wordpress」を含むエンティティを検索しています。 `service`エンティティとしては該当なしでしたが、続けて確認したところ`githubRepository`エンティティとしてはすでに登録されていることが分かりました。 ![](https://wp-api.wp-kyoto.net/wp-content/uploads/2026/06/08efd4fc8758f429e7b239b5d7887afd-20260605125843.png) Claudeの回答は、検索結果を次の表にまとめてくれました。これはPort.io側の画面そのものではなく、`list entities`ツールの結果をもとにClaudeが整形した回答です。 項目 値 Identifier wordpress-skills URL https://github.com/hideokamoto/wordpress-skills Default Branch main Language Astro Visibility public Last Push 2026-06-04T15:31:46Z ## 触ってみて Port.ioへの接続は、サーバーURLを自分で公式ドキュメントから拾ってくるという一手間はあるものの、他のコネクタと比べて特別難しいところはありませんでした。既存のソフトウェアカタログに何が登録されているかをチャットから確認できるのは、地味に便利そうです。 ## 参考 [https://docs.port.io/ai-interfaces/port-mcp-server/overview-and-installation/?region=us&mcp-setup=claude](https://docs.port.io/ai-interfaces/port-mcp-server/overview-and-installation/?region=us&mcp-setup=claude)