OrcaとほかのAIをつなぐ手順（その2）外のサービスと別の機械：GitHub・GitLab・Bitbucket・Linear・Jira、Design ModeとAnnotate AI Diff、スマホ、SSH――設定する場所、渡るデータ、外し方、うまくいかないときの確認点

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者は Orca を入れていますが、使い心地はこの記事には書いていません。設定やコマンドは「公式ページの例を、取得した要約から並べたもの」と、「この記事で組んだ案（動作は確かめていません）」を、そのつど区別します。コマンドや、スキル・サービスの登録など、システムに何かを足す操作は、公式ページの原文を見て入力してください。

先に結論

• GitHub、GitLab、Bitbucket、Linear、Jiraは、同じ「Settings → Integrations」の画面です。 ただし、認証の方式は、サービスごとに違います。
• エージェントに渡るものは、操作ごとに決まっています。 「Fix broken checks」は落ちた確認の名前とリンク、Linearのissueから起動すると説明・コメント・画像、といった具合です。
• 外し方は、書かれているものと、書かれていないものがあります。 Bitbucket Cloudの環境変数での上書き、スマホの「Remove」と再ペア、SSH先のManaged serversの「Stop…」「Forget…」は書かれています。GitHub、Linear、Jiraの切断の手順は、読んだページには見つかりませんでした。

前提：用語をそろえる

• OAuth / APIトークン：サービスにログインするときの方式（ブラウザで許可する）と、自分で発行する合言葉です。トークンは、パスワードのように扱います。
• ペアリング：スマホとデスクトップのOrcaを、1回限りのコードで結びつけることです。
• Relay：スマホとデスクトップのOrcaをつなぐ経路の1つです。公式は、サインインが要ると書いています。

連携の地図（この記事の範囲）

エージェントの接続、Orca CLI、スキル、Orchestration、自動実行、MCPの地図は、その1（07）にあります。

連携7：GitHub、GitLab、Bitbucket Cloud

手順（公式の「Hosted reviews, issues & Actions」と設定の一覧）

1. 「Settings → Integrations」で、使うサービスにつなぎます。GitHubは「OAuth」と設定の一覧にあります。GitHubの連携のページ自体は、OAuthの手順、gh CLIの設定、必要なスコープ、資格情報の保存場所を書いていません。
2. GitLabは、GitHubのページに「同じworktreeのレビューの流れでMRとissueを扱う」とありますが、Settings referenceにはGitLabの項目が見当たらず、つなぎ方の手順は読んだページに書かれていません（公式で確認できていません）。
3. Bitbucket Cloudは、同じ画面で「Connect」を押し、「Email & API token」（既定）か「Access token」を選びます。Orcaは、保存の前に資格情報を確かめます。環境変数 ORCA_BITBUCKET_* は、保存した資格情報より優先され、ConnectとDisconnectを上書きします。
4. つないだあと、サービスの画面から、PR/MR、issue、Actionsを見られます。PRからworktreeを作る、issueから作る、失敗したActionsのチップを押してログを見る、などです（06）。

AIとの連携になる場所

権限・外し方・確認点

• GitHubのAPIの残り枠は、「Settings → Git」の「GitHub API Budget」で、ローカルの gh CLIから見られます。
• GitHubの連携を外す手順は、読んだページには書かれていません。Bitbucket Cloudの環境変数での上書きは、上の2に書いたとおりです。
• 更新の失敗（レート制限、gh の認証、権限、ネットワーク）は、「Troubleshooting GitHub errors」のページを参照、とだけ書かれています（このページは読んでいません）。
• gh が見つからないと言われるが端末では動く場合は、05の手順の gh auth status -h github.com などで確かめます。
• 自動マージ、スタックしたPRなどの機能は、06とGitHubのページにあります。外から来るPRの本文やコメントは、エージェントに渡すと、命令文を含みうる点に注意してください（見立て）。

連携8：Linear

1. 「Settings → Integrations → Linear」を開き、個人のAPIトークンを貼ります（トークンの作り方は、Orcaのページには書かれていません。Linear側の「Settings → API」へのリンクがあります）。
2. 見たいチームを選びます。
3. タスクのドロワーで、GitHubとLinearのissueを同時に見られます。issueから作ったworktreeには、名前とissueのIDが結びつきます。
4. 「Edit Worktree Details」の「Issue」欄で、あとから結びつけられます。GitHubとLinearで共通の欄で、新しいリンクを保存すると、前のものと置き換わります（worktreeのページには、複数を結べる「Linked work」の記述もあります）。
5. エージェントからLinearを操作するには、orca linear と、orca-linear スキルを使います。操作の例に、save-issue、list-issues、関係の追加・削除があります。文脈のフラグに --activity、--full があります。CLI referenceには、orca linear の下に、status set、assignee set、priority set、comment add などが並びます。
6. スキルのページは、orca-linear の手引きが「untrusted-ticket rules」（信頼できないチケットの規則）を扱うと、名前だけ挙げています。全文は orca skills get orca-linear で読む形で、規則の中身は、読んだページには書かれていません。

渡るデータ：エージェントをLinearのissueから起動すると、説明、コメント、サブissueの画像やメディアが、依頼の文脈に入ります。issueの本文は、第三者が書いた文章かもしれません。

権限：トークンのスコープ、保存場所、外し方（Linear連携の切断）は、Linearのページには書かれていません。トークン自体はLinear側で管理するものなので、取り消しは、Linearの側の画面で、と読めますが、これはこの記事の読み取りで、公式の記載ではありません。

連携9：Jira

• 設定の一覧は、Jiraを「Cloud（メールとAPIトークン）」か、自分でホストするServer／Data Center（個人のアクセストークン、またはユーザー名とパスワード）と書いています。
• 「Jira items drawer」のページは、この記事では読んでいません。画面の操作や、資格情報の保存場所、外し方は、書けません。

連携10：Design ModeとAnnotate AI Diff（画面や差分をエージェントに渡す）

画面や差分に、第三者が書いた文字（ページの文面、コードのコメント）が含まれるときは、それも依頼に入ります。

連携11：スマホ、SSH、遠隔のサーバー

スマホ（beta）

1. デスクトップで、ペアリングのコード（1回限り、数分で切れる）を出します。
2. スマホのOrcaで「Pair」を選んで貼ります。端末ごとのトークンが作られます。
3. 経路は、Orca Relay（サインインが要る。デスクトップとスマホは、同じOrcaのアカウントで）、LAN、Tailscale。
4. 外し方：デスクトップがトークンを受け付けなくなると、スマホに認証の失敗が出ます。「Retry」、デスクトップからの「Re-pair」、スマホ側でホストを「Remove」して、ペアをやり直す、と書かれています。デスクトップ側でペアを取り消す操作の名前は、読んだページには書かれていません（設定の一覧には、サーバーとして公開するときの「取り消せるアクセスリンク」の記述があります）。Relayを通るデータの中身は、Mobile companionのページに書かれていません（公式で確認できていません）。

SSH（公式の「SSH worktrees」）

1. 「Settings → SSH → Add Target」で登録（06）。
2. 初回の接続で、Orcaが、そのホストに、固定された自前のサーバーを入れます。切る設定はありません。「Settings → Managed servers」で、Update、Roll back、Recover、Stop…、Forget… ができます（CLI：orca environment status|update|rollback|recover|stop|forget）。
3. エージェントとgitは遠隔で動き、鍵のパスフレーズは、Orcaが終わるまでメモリに保持されます（TTLは設定で長くできる）。
4. 設定の「Browser」にある「Browse through SSH workspace hosts」は、ブラウザの通信とDNSをSSHのホスト経由にします（設定の一覧の記載）。
5. SSHのターゲット自体を消す手順は、読んだページには書かれていません。

Remote Orca Server

• 設定の一覧に、「Remote Orca Servers」があり、ペアリング、SSH経由のインストール、Cloud VMの設定を扱うと書かれています。この記事では、専用のページを読んでいません。

渡るデータの一覧

気をつけること

• 運営者は Orca を入れていますが、使い心地はこの記事には書いていません。この記事は、公式の資料を読んだ範囲の手順書で、実際に使って確かめた記録ではありません。
• 外から来る文章は、命令を含みうる。 issueの本文、PRのコメント、Webページを、エージェントに渡すと、その文面に書かれた指示に従ってしまうことがあります。公式のページには、この一般的な説明は、読んだ範囲にはありません。許す操作を絞ることを、僕らは見立てとして挙げます。
• トークンと共有リンクは、認証情報です。 LinearやBitbucketのトークン、スマホのペアリングのコードは、パスワードのように扱ってください。公式の資料（04の整理）も、ペアリング用のURLや共有リンクを、認証情報として扱うよう書いています。
• 読んでいないページ。 Jira items drawer、Remote Orca Servers、Troubleshooting GitHub errors、Ways to run Orca、Browser-use profilesの本文は、今回は読んでいません。そこに書かれていることは、この記事に載せていません。
• 食い違い。 利用状況の設定の場所（Privacy）、アカウントの有無（テレメトリのページ「アカウントの仕組みがない」と、Artifactsの「Orca account」）を併記しました。
• beta・Experimental。 スマホ、Remote Orca Server、Cloud VMなどは、仕様が変わる可能性があります。
• 法律や契約の解釈は、公式の規約や専門家に確認してください。この記事は助言ではありません。

出典

• Hosted reviews, issues & Actions（Orca Docs、確認日 2026-10-25）
• Linear items drawer（Orca Docs、確認日 2026-10-25）
• Commit & push from Orca（Orca Docs、確認日 2026-10-25）
• Annotate AI Diff（Orca Docs、確認日 2026-10-25）
• Design Mode（Orca Docs、確認日 2026-10-25）
• SSH worktrees（Orca Docs、確認日 2026-10-25）
• Mobile companion（Orca Docs、確認日 2026-10-25）
• Settings reference（Orca Docs、確認日 2026-10-25）
• Orca CLI reference（Orca Docs、確認日 2026-10-25）
• Troubleshooting & FAQ（Orca Docs、確認日 2026-10-25）
• Privacy & Telemetry（Orca Docs、確認日 2026-10-25）