---
title: MCPサーバーを追加する
description: サーバーを作成し、誰が接続できるか、どの操作を提供するかを選び、AIクライアントから使う人にエンドポイントを共有します。
sidebar:
  order: 2
area: ai
feature: mcp-servers
appPath: /ai/agents/mcp-servers
lastVerified: 2026-11-03
version: "2026-11-02"
audience: admin
related:
  - ai/mcp-servers
  - ai/mcp-servers/connect-an-ai-client
  - settings/users
  - ai
translation:
  source: ai/mcp-servers/add-an-mcp-server.mdx
  sourceSha: 399cbaac900fa77894625d79f0ba31875b615007
---

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

## 始める前に

- あなたが管理者またはオーナーであること。ナビゲーションに**AI**が表示されるのはこれらのロールだけです。
- 変わらない名前を決めておくこと。小文字の英字、数字、ハイフンで、英字で始まり、63文字までです。
- 提供したい操作、または最も近いプリセットを把握しておくこと。ピッカーには、あなた自身が呼び出せる操作だけが表示されます。

![Add MCP server: the details step, before choosing operations.](https://support.pyn.ai/media/ai/mcp-servers/ai-mcp-servers-add.png)

## 手順

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**を選びます。右側にサーバーのパネルが開きます。

> **Note:** 保存に失敗すると、ページに「The server could not be saved. If you are adding a server, its name may already be in use.」と表示されます。アーカイブしたサーバーの名前は再び使えます。

## 確認できること

![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.](https://support.pyn.ai/media/ai/mcp-servers/ai-mcp-servers-panel.png)

パネルは「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クライアントを接続する](https://support.pyn.ai/ja/ai/mcp-servers/connect-an-ai-client/)にあります。クライアントはその人を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サーバー](https://support.pyn.ai/ja/ai/mcp-servers/)：アクセスの決まり方についてです。
- [AIクライアントを接続する](https://support.pyn.ai/ja/ai/mcp-servers/connect-an-ai-client/)：アドレスをClaude、Claude Code、ChatGPTに追加するにはこちらです。
- [ユーザー](https://support.pyn.ai/ja/settings/users/)：各ロールができることについてです。
- [AI](https://support.pyn.ai/ja/ai/)：Pynに組み込まれたエージェントについてです。
