> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LinearをCognoに連携する

> Linearを連携すると、Projectごとに選んだLinearチームで作業し、新しい課題やコメントを拾い、エージェントが課題を扱えます。

![Linear](https://mintcdn.com/genaxis/Tp7j-hc27XxF4-cW/images/integrations/linear.svg?fit=max\&auto=format\&n=Tp7j-hc27XxF4-cW\&q=85\&s=091d1d3b708050f1d143065575436d44)

## 概要

| | |
| - | - |
| **方向** | 双方向 — Cognoが新しい課題・割り当て・コメントを拾い、エージェントは許可した場合に限り課題を変更します。 |
| **接続方法** | Linear OAuth — ワンクリック。 |
| **設定できる人** | viewer以外のワークスペース member。 |
| **必要なもの** | 接続したいLinearワークスペースのアカウント。 |

Linearを接続すると、Projectごとに作業するLinearチームを選べます。Cognoはそのチームの新しい課題・割り当て・コメントを拾い、Projectのエージェント実行は課題を検索・読み取りでき、許可した場合は課題の作成・更新とコメントの追加もできます。Projectが選んだチームの外には、そのエージェントは届きません。

## 事前確認

* 対象ワークスペースのmemberで、ロールがviewerではない。
* Cognoに使わせたいチームが見えるLinearアカウントにサインインしている。

## CognoでLinearを接続する

**1. Linearを探す**

**連携** を開き、**Linear** を探します。

**2. Linearを認可する**

**接続** を押します。ブラウザでLinearの認可画面が開くので、Linearワークスペースへのアクセスを承認します。

**3. 接続を確認する**

Cognoに戻るとLinearのページが開きます。接続行にLinearワークスペース名が **接続済み** として表示されます。

## Cognoが使えるLinearチームを見る

**Linearチーム** セクションに、この接続から見えるチームが、名前・キー（例: `ENG`）、非公開チームには **非公開** バッジ、Linearで開くリンクつきで並びます。セクション見出しの横の **Linear で … を開く** から、Linearワークスペースを開けます。一覧を最後に更新した時刻は接続行に表示されます（**最終同期** — または **未同期**）。

Cognoは接続した直後にこの一覧を作り、以後6時間ごとに更新します。今すぐ更新するには、接続行の **⋯** メニューから **チームを同期** を選びます。更新には数秒かかります。

## ProjectのLinearチームを選ぶ

Projectごとに自分のLinearチームを選びます。

**1. Projectの設定を開く**

Projectを開いて設定に進み、**Projectの連携** の中の **Linear** を探します。

**2. チームを選ぶ**

**Linear** を展開し、**チーム** でこのProjectが作業するチームを選びます。

選択肢は、連携ページの **Linearチーム** セクションと同じチームです。

> [!NOTE]
>
> Linearチームを1つも選んでいないProjectは、Cognoから見えるすべてのチームを対象にします。Linearツールも、下で説明する動きの受け取りも同じです。絞り込みたいときはチームを選んでください。

## CognoがLinearから拾うもの

Cognoは、人による次の3種類の動きに反応します。

| 動き | 対象になるとき |
| - | - |
| 新しい課題 | 誰かが課題を作成したとき。 |
| 割り当て | 課題が誰かに割り当てられたとき。ステータス・ラベル・タイトルなどほかの更新や、割り当ての解除は拾いません。 |
| コメント | 誰かが課題にコメントしたとき。 |

それぞれ、その課題のチームを選んだProjectに届きます。Linearを何も選んでいないProjectには、すべてのチームの動きが届きます。同じ課題への動きは、待っている間は1件にまとまります。Cogno自身や、ほかのアプリ・連携による変更は無視します。

## エージェントツールのアクセスを設定する

**エージェントツール** セクションで、Engine管理の実行がこの接続で行える操作を決めます。機能ごとに **ブロック**、**確認**、**許可** を選びます。変更は次の実行から反映され、接続を解除するとすぐに利用できなくなります。

| 機能 | 許可される操作 | 既定値 |
| - | - | - |
| **Linearを読み取る** | Projectで選択したLinearチームの一覧と、課題・コメントの検索と読み取り。 | **許可** |
| **Linearに書き込む** | Projectで選択したLinearチームでの課題の作成・更新とコメントの追加。 | **許可** |

各機能の下にある **ツール** に、その機能が付与するツールがすべて並びます。読み取りは `linear_list_teams`・`linear_search_issues`・`linear_get_issue`、書き込みは `linear_create_issue`・`linear_update_issue`・`linear_add_comment` です。変更を1件ずつ承認したい場合は、**Linearに書き込む** を **確認** にします。Workspaceの値が上限です。Projectではこの接続について継承または縮小できますが、広げることはできません。詳しくは [連携](/docs/ja/integrations.md) のTool権限の説明を参照してください。

## 接続を解除する

接続行の **⋯** メニューから **接続を解除** を選び、確認します。

## よくある状態

| State | Meaning | Next action |
| - | - | - |
| **Linearチームはまだありません。** | 一覧がまだ作られていないか、アカウントから見えるチームがない | **チームを同期** を選び、Linearでのチームの参加状況を確認します |
| 作ったばかりのチームが無い | 作成後にまだ更新されていない | **チームを同期** を選びます |
| **Linearチームを読み込めませんでした。** | チーム一覧を読み込めなかった | ページを再読み込みします |
| エージェントが「このProjectから届くLinearチームがない」と返す | ProjectのLinearの対象が空 | Projectの設定でチームを選びます |

## 参照URL

* [Linear ドキュメント](https://linear.app/docs)

## 関連docs

* [連携](/docs/ja/integrations.md)
* [Projects](/docs/ja/projects.md)
* [Troubleshooting](/docs/ja/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.