コンテンツにスキップ
PynPyn

MCPサーバーを追加する

人事チームが、ワークスペース全体を渡すことなく、来週誰が入社するかをAIアシスタントに尋ねられるようにしたいとします。MCPサーバーは、最低ロールを持つ名前付きの操作の束です。詳細、次に操作という2つのステップで作成するか、プリセットから始めて、そのエンドポイントを配ります。

  • あなたが管理者またはオーナーであること。ナビゲーションにAIが表示されるのはこれらのロールだけです。
  • 変わらない名前を決めておくこと。小文字の英字、数字、ハイフンで、英字で始まり、63文字までです。
  • 提供したい操作、または最も近いプリセットを把握しておくこと。ピッカーには、あなた自身が呼び出せる操作だけが表示されます。
The Add MCP server page with Name, Title, Description and Minimum role fields.
Add MCP server: the details step, before choosing operations.
  1. Pynで左のナビゲーションのAIを開き、Agentsの下のMCP Serversを開きます。

  2. Addを選びます。Add MCP serverページが開きます。代わりに、あらかじめ用意された束から始めるには、Addの横の矢印を開いてAdd from Presetを選びます。ピッカーには2つのカテゴリー、Read only(People Directory、Workspace Explorer)とRead and write(Flow Author、Flow Operator、Forms and Polls、Journey Mapper、Onboarding Coordinator)があります。各プリセットには説明、含まれる操作の数、必要なロールが表示されます。1つ選ぶと名前、タイトル、説明、最低ロール、操作が入力され、すべてあとから変更でき、その後サーバーがプリセットに結び付くことはありません。プリセットにはワークスペースが提供する操作だけが表示され、core_getTemplate以外に何も残らないプリセットは表示されません。

  3. Name(たとえばpeople-directory)を入力します。フィールドには「Lowercase letters, numbers and hyphens. It cannot be changed later.」と説明があります。

  4. TitleとDescriptionを入力します。「Tells people, and their AI client, what this server is for.」とあるとおりです。

  5. Minimum roleをOwner、Admin、Power User、Userから選びます。「Only people with this role, or one above it, can connect.」とあるとおりです。Nextを選びます。

  6. Operationsの下には、core_getTemplateがすでに並んでいます。これはクライアントがテンプレートのプロパティを調べ、読み取ったアイテムを理解できるようにするもので、他の操作と同じように削除できます。検索して、さらに操作を1つずつ追加します。各操作にはReadまたはWriteのチップが付き、検索ボックスの下の行には「n / 100 selected」という数に続いて、選んだ操作が作るツール一覧のサイズがキロバイトとおおよそのトークン数で表示されます(例:「108 KB · ≈31,000 tokens」)。この一覧は、AIクライアントが接続するたびに読み込むものです。256 KBを超えると「A tool list this large takes a noticeable slice of the AI client’s context on every connect. Consider offering fewer operations.」という注意書きが表示されます。削除するにはその行を選びます。行の末尾のごみ箱アイコンは、行を選ぶと何が起きるかを示しています。

  7. Addを選びます。右側にサーバーのパネルが開きます。

The People directory server panel: a callout with the address AI clients connect to, a How to connect an AI client link and a Copy URL button, then the Operations tab with the description and the operations, and an Advanced tab.
Select a server to open its panel: edit the description, copy the address AI clients connect to, and see its operations; Advanced holds the minimum role and schema size.

パネルは「AI clients connect to this address.」というコールアウトとともに開き、その下にアドレス、そのガイドをページの上に重なるHelpシートで開くHow to connect an AI clientリンク、Copy URLボタンがあります。ボタンは選んだあとしばらくCopiedと表示されます。コールアウトの下には2つのタブがあります。ラベルに件数が付いたOperationsには、その場で編集できる説明(空の場合は「(No Description)」と表示されます)と、続いて各操作がReadまたはWriteのチップ付きで並びます。タブ列の末尾にあるAdvancedには、Minimum Roleと、ツール一覧の重さをキロバイトとおおよそのトークン数で示すSchema sizeがあり、一覧が256 KBを超えると同じ注意書きがその下に表示されます。

アドレスをAIクライアントのMCP設定に貼り付けます。Claude、Claude Code、ChatGPTのどこに入力するかはAIクライアントを接続するにあります。クライアントはその人をPynに送り、そこでいつもどおりサインインすると(その画面から始めたマジックリンクやSSOのサインインは、その画面に戻ります)、「Connect client?」が表示されます。「Client is asking to use server title in workspace as you. It can only do what that server offers and you are allowed to do.」とあります。その下の行には、クライアントが得るツールの数がreadとwriteに分けて表示され、Showを選ぶとCan readとCan change dataの一覧が開き、各ツールが元のアプリに続けてタイトル(Get item)で示されるので、クライアントが何をできるようになるかを正確に確認できます。Who am Iはすべての接続に付いてきて、この数には含まれません。ロールがどのツールにも届かない人には「Your role does not allow any of the tools this server offers.」と表示されます。Allowを選ぶと接続済みの状態でクライアントに戻り、Denyは拒否します。サーバーのMinimum roleに満たない人にはConnection Failedと「Your account is not allowed to connect to this server.」が表示され、長く放置されたリクエストには「This request has expired. Start again from your AI client.」と表示されます。接続すると、クライアントのツール一覧にWho am I(who_am_i)が表示されます。これは、その接続が誰として動いているか(人、ワークスペース、サーバー)を答えるので、クライアントが誰として作業しているかを確認できます。加えて、サーバー上の操作のうちその人自身のロールが許可するものに1つずつ、操作にちなんだ名前のツール(たとえばcore_getItem)が表示され、クライアントがタイトルを表示する場合は言葉のタイトル(Get item)が付きます。各ツールはその人として実行され、ロールが届かない操作は表示されず、呼び出せません。Writeのツールはデータを変更し、そのように印が付くため、そうした変更を確認するクライアントは先にその人に尋ねます。MCPサーバーを管理する操作は決して提供されず、MCPサーバーや接続を指す呼び出しは拒否されます。ブラウザーで動くクライアントも、デスクトップのクライアントと同じ方法で接続します。サーバーの行にはActiveと表示されます。一時的に止めるには行のメニュー(…)のDisableを使います。これにより既存の接続もすべて切れます。

  • MCPサーバー:アクセスの決まり方についてです。
  • AIクライアントを接続する:アドレスをClaude、Claude Code、ChatGPTに追加するにはこちらです。
  • ユーザー:各ロールができることについてです。
  • AI:Pynに組み込まれたエージェントについてです。