# Notion、Linear などのアプリ

> Notion、Linear、Atlassian、Figma、GitHub などのアプリを自分用またはチーム用につないで AI が使えるようにする方法と、それぞれに必要なアドレスやキーの入手先です。

AI は Trina AX の外にあるアプリをあなたの代わりに使えます。Notion のページを検索する、Linear の課題を開く、Jira のチケットを読む、といったことです。アプリは 1 回つなげば済みます。ほとんどのアプリはコピーするものがなく、アプリ自身のページでログインするだけです。GitHub など一部のアプリは、代わりにキーを発行します。

> **注意:** 0.4.0 より前のバージョンでは、この画面の名前は **External services** です。これらの接続には、アプリが AI にツールを提供するための一般的なしくみである MCP を使います。使うだけなら、それ以上知る必要はありません。

## アプリのつなぎ方

| アプリ | 必要なもの | ガイド |
|---|---|---|
| Notion、Linear、Atlassian（Jira、Confluence）、Figma、Canva、Stripe、Supabase、Cloudflare、Higgsfield など **見つける** にあるアプリ | そのアプリのあなたのアカウント。コピーするものはありません | [「見つける」のアプリにログインする](#見つけるのアプリにログインする) |
| GitHub | 個人用アクセストークン | [GitHub](#github) |
| 「MCP server」のアドレスを公開しているその他のアプリ | そのアドレスと、アプリが求める場合はキー | [アドレスでアプリを追加する](#アドレスでアプリを追加する) |
| 会社独自のシステム（API） | アドレス、キー、メモ | [会社の API](/docs/ja/use/api-connections.md) |
| Google Drive、Gmail、カレンダー、ドキュメント、スプレッドシート | あなたの Google アカウント | [Google アプリ](/docs/ja/use/google-apps.md) |
| Slack | メンバーは不要。管理者が 1 回追加します | [Slack](/docs/ja/use/slack.md) |

## 自分用かチーム用か

| | 自分用 | チーム用 |
|---|---|---|
| 場所 | **設定 › コネクター** | **管理 › 連携サービス**（オーナーと管理者） |
| AI が使うアカウント | あなたのアカウント | ログインしたアカウント、または保存されたキー |
| 使う人 | あなただけ（自分のチャットで） | 管理者が選んだ全員、グループ、または個人 |
| 見られる人 | あなただけ（管理者も見られません） | 管理者 |

チームの接続は **1 回、1 つのアカウントとして** ログインします。対象の全員が、そのアプリではそのアカウントとして動きます。各自が自分として動くべき場合（自分の Notion ページ、自分の GitHub の権限など）は、代わりに [テンプレート](#テンプレートメンバーが各自のキーを使う) を作るか、各自が自分用につなぐようにします。

## 「見つける」のアプリにログインする

> **ヒント:** **必要なもの**
>
> - そのアプリ（Notion、Linear など）のアカウント。ブラウザーでログインしておきます。
> - コピーや貼り付けはありません。Trina AX がアプリの公式アドレスを入力します。

1. **コネクターを開く**

   左のバーの下にある自分の写真を選び、**設定 › コネクター** を開きます（スマートフォンでは **自分** タブ）。**見つける** に、つなげるアプリが並んでいます。**すべて表示** ですべてのアプリが表示され、**アプリを検索** で名前から探せます。

   ![コネクター（Connectors）：まだ何もつないでおらず、同じページの下に見つける（Discover）がある画面](../../images/mcp/connected.webp "設定 › コネクター")

2. **アプリを開いて接続を選ぶ**

   アプリのページには、AI がそこでできることとツールの一覧があります。**接続**（または一覧の **+**）を選びます。メンバーには、チーム全体で使えるよう依頼する **管理者に追加を依頼** も表示されます。

   ![設定 › コネクターの Notion のページ：接続、チーム全体で使いたいですか？管理者に追加を依頼、AI ができること、ツールの一覧](../../images/connect/notion-page.webp "Notion のページ")

3. **保存してログイン**

   ダイアログにアプリの公式アドレスが表示されます。**詳細設定** はそのままにして、**保存してログイン** を選びます。

   ![Notion を追加するダイアログ：入力済みのアドレス、閉じた詳細設定（Advanced）、保存してログイン（Save and sign in）](../../images/mcp/add.webp "Notion を追加")

4. **アプリのページでアクセスを許可する**

   アプリ自身のページ（Notion、Linear など）が新しいウィンドウで開きます。求められたらログインし、ワークスペースを選んで **Allow**（ボタン名は **Continue** や **Accept** のこともあります）を選びます。ウィンドウが閉じ、Trina AX に **ログインしました。** と表示されます。アプリは **自分のコネクター** に移り、**接続済み** と表示されます。

チーム用には、管理者が **管理 › 連携サービス** で同じことを行います。アプリを開いて **チーム用に接続** を選びます。横の矢印から **テンプレート：メンバーが各自接続** も選べます。そのあと、使ってよい人を選びます。

![管理 › 連携サービスの Notion のページ：ほかの選択肢を開く矢印付きのチーム用に接続（Connect for the team）と、共有キー 1 つでチーム用に接続するか、各メンバーが自分のキーでつなぐテンプレートにするかの説明](../../images/connect/admin-notion.webp "チーム用の Notion")

ログインはパソコン（ブラウザーまたはデスクトップアプリ）で行う必要があります。一度つなげば、スマートフォンでも使えます。

## GitHub

GitHub は他のアプリが独自にログインすることを認めていないため、個人用アクセストークンでつなぎます。アドレスでアプリを追加できるのはオーナーと管理者だけです。メンバーは管理者に頼みます。管理者は、各自が自分のトークンを使えるよう [テンプレート](#テンプレートメンバーが各自のキーを使う) を作れます。

> **ヒント:** **必要なもの**
>
> - **アドレス**：`https://api.githubcopilot.com/mcp/`（GitHub の MCP サーバー）。
> - **キー**：GitHub の個人用アクセストークン。`github_pat_` で始まります。

1. **GitHub でトークンを作る**

   [GitHub › Settings › Developer settings › Personal access tokens › Fine-grained tokens](https://github.com/settings/personal-access-tokens/new) を開き、**Generate new token** を選びます。名前（「Trina AX」）、有効期限、開けるリポジトリ（**Only select repositories** がいちばん安全です）、AI に必要な権限を設定します。たとえば **Contents**、**Issues**、**Pull requests** を **Read-only** に、AI に変更させてよいなら **Read and write** にします。**Generate token** を選んでコピーします。トークンは一度しか表示されません。詳しくは [GitHub のガイド](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) を見てください。

2. **Trina AX に追加する**

   **管理 › 連携サービス** で、**アドレスで追加**（見つけるの下）または **追加** を選びます。次のように入力します。

   - **名前**：`GitHub`
   - **アドレス**：`https://api.githubcopilot.com/mcp/`
   - **詳細設定** を開き、**ログイン方法** を **APIキー** にします。
   - **キーを送るヘッダー**：**Authorization: Bearer（既定）** のままにします。
   - **キー**：トークンを貼り付けます。

   ![GitHub 用に入力したチーム用アプリの追加画面：アドレス https://api.githubcopilot.com/mcp/、キーを送るヘッダー Authorization: Bearer（既定）、キー、詳細設定にチーム用（キー 1 つ）、MCPサーバー、APIキー、毎回確認](../../images/connect/add-by-address-key.webp "トークンでつなぐ GitHub")

3. **保存する**

   **保存** を選びます。Trina AX が GitHub にトークンを確認し、提供されるツールを一覧にします。行に **接続済み** と表示されます。

## アドレスでアプリを追加する

「MCP server」のアドレスを公開しているアプリなら、見つけるにないものでも追加できます。オーナーと管理者が **管理 › 連携サービス** › **アドレスで追加** で追加します。メンバーには「一覧にありませんか？管理者に追加を頼んでください。」と表示されます。

> **ヒント:** **必要なもの**
>
> - **アドレス**：アプリのヘルプページにあります。たいていは「MCP」「MCP server」「Connect to AI tools」といったページです。`https://` で始まり、`/mcp` で終わることがよくあります。
> - アプリのログイン方法：アプリ自身のページで行う（**ログイン（OAuth）**）、キーを使う（**APIキー**）、またはログインなし（**なし**）。
> - キーを使う場合：アプリの設定（「API keys」「Tokens」「Developer」）で作る **キー** と、アプリのヘルプに `X-API-Key` などの名前があれば **ヘッダー名**。

ダイアログの欄：

| 欄 | 入れるもの |
|---|---|
| **名前** | チャットで表示される名前（「GitHub」など）。 |
| **アドレス** | アプリの MCP アドレス。`https://` で始まります。 |
| **接続する人**（詳細設定） | **チームで1つ** または **メンバーごとに各自**。 |
| **種類**（詳細設定） | **MCPサーバー**。ふつうの Web API の場合だけ **API** を選びます。[会社の API](/docs/ja/use/api-connections.md) を見てください。 |
| **ログイン方法**（詳細設定） | アプリのヘルプに従って **ログイン（OAuth）**、**APIキー**、**なし** のどれか。 |
| **キーを送るヘッダー** | アプリのヘルプに別のヘッダーが書かれていなければ、**Authorization: Bearer（既定）** のままにします。書かれていれば **別のヘッダー** を選び、その **ヘッダー名** を正確に入力します。 |
| **キー** | キー全体を貼り付けます。保存後は二度と見られません。 |
| **自分のアプリでログイン**（詳細設定） | Google の MCP サーバーのように、自分でログイン用アプリを作るよう求めるアプリの場合だけ使います。[自分のアプリでログインする](/docs/ja/use/api-connections.md#自分のアプリでログインする) を見てください。 |
| **書き込み・削除・送信**（詳細設定） | AI が先に確認するかどうか（下記）。 |

> **警告:** キーは必ず **キー** の欄に入れ、アドレス（`…?key=…`）には入れないでください。チームの接続を使う人はそのアドレスを見られ、AI もアドレスを読みます。

## 変更には OK が必要

読み取りはすぐに実行されます。それ以外はすべて書き込みとして扱われ、接続の **書き込み・削除・送信** の設定に従います。

| 設定 | 動き |
|---|---|
| **毎回確認**（既定） | Trina AX が、送られる内容をすべて載せたカードを表示します。誰かが OK するまで何も送られません。 |
| **書き込みをブロック** | 参照だけができ、書き込みは拒否されます。 |
| **確認なしで実行** | 書き込みを確認なしで実行します。選べるのは管理者だけで、チームの接続に限られます。 |

接続を管理する人は、その接続のページでツールを 1 つずつオフにすることもできます。アプリから返ってきた内容は外部のデータとして扱われ、指示として扱われることはありません。定期タスクでは誰も OK できないため、書き込みは拒否されます。例外は、タスクのカードで許可された **確認なしで実行** のチームの接続です。

## テンプレート：メンバーが各自のキーを使う

多くのアプリでは、キーにはその持ち主の権限が付き、すべての呼び出しがその人の名前で記録されます。そうしたアプリには、管理者が **テンプレート** を追加します。アプリを 1 回登録し、各メンバーが自分のキーやログインでつなぎます。

1. **テンプレートを追加する**

   **管理 › 連携サービス** で **アドレスで追加** を選びます（または、アプリのページで **チーム用に接続** の横の矢印 › **テンプレート：メンバーが各自接続**）。**詳細設定** で **接続する人** を **メンバーごとに各自** にします。アドレス、ログイン方法、対象の人を入力します。キーの欄はなく、アドレスに `?…` の部分は付けられません。そこにキーがあると全メンバーに届いてしまうからです。**メンバーへのメモ（任意）** で、キーの入手先を伝えられます。

   ![GitHub をテンプレートとして追加するチーム用アプリの追加画面：キーはここには入れず各メンバーが自分のキーを追加するという表示、接続する人がテンプレート、トークンの作り方を書いたメンバーへのメモ](../../images/connect/template.webp "テンプレート")

2. **メンバーがつなぐ**

   対象のメンバーには **アクティビティ** に通知が届き、**設定 › コネクター** の **自分のコネクター** に、**チーム** のラベルと **接続** 付きで表示されます。メンバーは自分のキーを入力するか、ログインします。それはその人自身の接続になり、その人のチャットでだけ使われます。

| | チームの接続（キー 1 つ） | テンプレート |
|---|---|---|
| キー | 管理者が追加した 1 つ | 各メンバー自身のキー |
| AI が使う権限 | 全員についてキーの持ち主の権限 | 各メンバー自身の権限 |
| 管理者に見えるもの | 接続 | 誰がいつつないだか、誰のキーが使えなくなったか。キーは見えません |

管理 › 連携サービスのテンプレートの行で **テンプレート · N人接続** を選ぶと、対象の人と状態（**接続済み**、**未接続**、**キーが使えなくなりました**）が表示されます。テンプレートが必要な定期タスクは、自分のキーがないと実行されません。結果に「（名前）のあなた自身のキーが必要です」と表示され、**接続** へのリンクが付きます。

メンバーが変えられるのは、自分のキーまたはログインと、書き込みの設定だけです。接続はいつでも解除できます。管理者がテンプレートのアドレスやログイン方法を変えると、全メンバーのキーが削除され、つなぎ直しになります。名前やメモを変えただけなら、全員の接続はそのまま残ります。テンプレートを削除したり、対象から人を外したりすると、その人たちの接続は削除されます。

## メンバーに接続を依頼する

管理者は、アプリを入力済みにした依頼を 1 人のメンバーに送ることもできます。**管理 › 連携サービス** › **追加** の横の矢印 › **メンバーに接続を依頼** です。メンバーには通知が届き、自分のキーでつなぐか、断ります。管理者がキーを見ることはありません。

## チャットからつなぐ

チャットで「Linear をつないで」と頼むこともできます。AI がアプリの公式アドレスを入力し、カードを表示します。あなたはログインするか、カードにキーを貼り付けるだけです。キーが AI に届くことはありません。

## 困ったとき

| 表示 | 対処 |
|---|---|
| **ログインが必要** | ログインが切れたか、アプリ側でキーが取り消されました。接続を開いて **再ログイン** または **キーを置換** を選んでください。 |
| **ログインはまだ終わっていません。** | ログインのウィンドウが閉じられたか、別のウィンドウの後ろにあります。**ログインウィンドウを開く** を選ぶか、キャンセルしてもう一度試してください。 |
| **サービスでアクセスが許可されませんでした。** | アプリのページで Cancel または Deny を選びました。もう一度ログインして許可してください。 |
| **接続を確認できませんでした。**（理由に「401」や「unauthorized」がある） | キーが間違っている、期限切れ、または空白付きでコピーされています。アプリのコピーボタンでもう一度コピーしてください。Bearer 以外のヘッダーの場合は、**ヘッダー名** を 1 文字ずつ確認してください。 |
| **サービスからツールが提示されませんでした。** | そのアドレスは MCP のアドレスではありません（アプリのホームページを貼り付けていることがよくあります）。アプリの MCP のヘルプページにあるアドレスを使ってください。 |
| メンバーがアプリを見つけられない | メンバーは **見つける** からしかアプリをつなげません。アドレスで、またはテンプレートとして追加するよう管理者に頼んでください。 |

## 逆の方向

逆に、あなた自身の Claude（Claude Code、Claude Desktop、claude.ai）から **Trina AX に** つないで、あなたの権限でファイルを使うこともできます。[Team AX MCP コネクターについて読む](/docs/agents/mcp-connector.md)（英語）。

開発者向けの詳しい情報：[Integrations](https://github.com/trina-app/trina-ax/blob/main/docs/INTEGRATIONS.md)（英語）。
