Slack & Teams ボット

Organization Bot tab: Slack connected, Teams, channel scope with #payments scoped to a team, and MCP tools

チームがすでに使っているツールに Archyl を取り込みましょう。Slack や Microsoft Teams で @Archyl をメンションして、ソフトウェアアーキテクチャ（C4 モデル、ADR、依存関係、オーナーシップなど）について質問すると、実際のデータに基づいた回答がチャンネル内で直接得られます。

概要

ボットは組織単位で接続します。管理者がワークスペースを接続すると、その中の誰でもボットをメンションして質問できます。ボットは接続した管理者の権限で回答し、対象範囲は組織のプロジェクトです。

既定では、その対象範囲は組織のすべてのプロジェクトです。管理者はどのチャンネルでもチームや特定のプロジェクトに絞ることができます。後述のチャンネルをチームやプロジェクトに絞るを参照してください。

ボットの回答方法は 2 通りあります。

モード 条件 表示される内容
ダイレクト API キー未選択 アーキテクチャのコンテキストから生成された 1 件の AI 回答。
エージェント（MCP ツール） API キー選択時 ボットがライブ MCP ツールを呼び出して調査・操作し、実行した手順（🔧 …）を最終回答の前に表示します。

組織 → ボット → MCP ツールで API キーを選択することで切り替えます（下記の MCP ツールを有効にする を参照）。

Slack を接続する

  1. Archyl で 組織 → ボット を開きます。
  2. Slack に追加 をクリックします。Slack に移動して Archyl アプリを承認し、ワークスペースを選択します。
  3. 承認すると Archyl に戻り、ワークスペースが 接続済み に表示されます。
  4. Slack でボットをチャンネルに招待し、メンションします。
    @Archyl 決済サービスに依存しているものは？

ボットはチャンネルを整理された状態に保つため スレッドで返信 します。フォローアップの質問をするには、（チャンネルまたはスレッド内で）もう一度メンションします。

  • 編集 は Slack のインストールを再実行します（接続を更新）。
  • 切断 は連携を削除します。

Microsoft Teams を接続する

Teams はアプリパッケージと一度限りのリンクコードを使用します。

  1. Archyl で 組織 → ボット を開き、Teams アプリをダウンロード をクリックして archyl-teams-app.zip を取得します。
  2. Teams でアプリをインストールします：アプリ → アプリを管理 → カスタムアプリをアップロード から .zip を選択します。(このオプションが表示されない場合は、Teams 管理者がカスタムアプリのアップロードを許可するか、組織のアプリカタログにアップロードする必要があります。)
  3. Archyl に戻り、Teams を接続 をクリックします。@Archyl link 6GXH6NKL のようなコードが表示されます。
  4. Teams で、そのメッセージをそのまま Archyl ボットに送信します（1:1 チャットでは link 6GXH6NKL だけで OK）。ボットが ✅ Archyl 組織に接続しました。 と返信します。
  5. 質問でメンションしてみましょう。
    @Archyl API ゲートウェイの所有チームは？

リンクコードは 15 分間有効で、一度きりです。ボットタブからいつでも新しいコードを生成できます。

注意： Microsoft Teams のボットには職場または学校（Microsoft 365）アカウントが必要です。個人用 Microsoft アカウントでは動作しません。

MCP ツールを有効にする（エージェントモード）

既定では、ボットはアーキテクチャのコンテキストから直接回答します。ライブ MCP ツールを使用させる（名前でプロジェクトを検索、依存関係の追跡、ADR やドキュメントの作成など）には、API キーを与えます。

  1. プロフィール → API キー で API キーを作成します（既存のものを再利用しても構いません）。
  2. 組織 → ボット → MCP ツール に移動し、そのキーを選択します。
  3. これで完了です。次に誰かがボットをメンションすると、MCP サーバー のツールを使ってアーキテクチャを推論し、回答前に実行した各アクションを表示します。

スコープが重要です：

  • 読み取りキーでは、ボットは情報を検索できますが、何も変更できません。
  • 書き込みキーでは、さらに要素・ADR・ドキュメントなどの作成や更新ができます。ボットに変更を行わせたい場合のみ書き込みキーを選択してください。

いつでも なし を選択すると、エージェントモードをオフにしてダイレクト回答に戻せます。

チャンネルをチームやプロジェクトに絞る

既定では、どのチャンネルからも組織のすべてのプロジェクトが見えます。多くの場合はそれで問題ありませんが、#payments のようなチャンネルが融資プラットフォームについて答えるべきではないこともあります。

絞り込むには、組織 → ボット → チャンネルのスコープ を開き、チャンネルを絞り込む をクリックします。

  1. チャンネルが参照する範囲 — チーム、または1つ以上のプロジェクト。
  2. 対象チャンネル — プラットフォームを選び、一覧用にチャンネル名を入力して コマンドを取得 をクリックします。
  3. コマンドを貼り付け — そのチャンネルで @Archyl scope <コード> を送信します。ボットが確認し、適用され次第チャンネルが一覧に表示されます。

コードは15分間有効で、1回だけ使用できます。チャンネルの範囲を元に戻すには、一覧でそのチャンネルの横の 解除 をクリックします。

なぜボタンではなくコードなのか ボットは接続した管理者の権限で回答し、チャンネル内で誰が発言しているかを判別できません。コードが認可そのものです。Archyl の管理者が発行したものなので、チャンネルに書き込めるだけの人がスコープを変更することはできません。

知っておくとよい点:

  • チームスコープはチームに追従します。 後からそのチームに追加されたプロジェクトも自動的に対象となり、チャンネルを設定し直す必要はありません。
  • スコープは提案ではなく強制です。 すべてのツール呼び出しと一覧取得に適用されるため、ID を指定して依頼されても、スコープ外のプロジェクトは読み取れません。
  • 組織レベルの ADR・ドキュメント・API コントラクトは引き続き参照できます。 これらは特定のプロジェクトではなく組織に属するためです。
  • 名前は一覧用のラベルです。 ボットはチャンネル名を取得できないため、入力した名前が一覧に表示されます。実際の紐付け先は、コマンドを貼り付けたチャンネルです。

権限の仕組み

  • ボットはワークスペースを接続した管理者の権限で、組織のプロジェクトの範囲内で回答します。
  • 絞り込まれたチャンネルは、そのチームまたはリストのプロジェクトだけを参照します。これはプロンプト任せではなく、すべてのツール呼び出しと一覧取得で強制されます。
  • エージェントモードでは、ボットが読み取り・変更できる範囲は、さらに選択した API キーのスコープによって制限されます。
  • 各質問は、アプリ内チャットと同様に組織の AI 利用量にカウントされます。

ヒント

  • 名前で具体的に。 プロジェクト、システム、ADR、ドキュメントを名前で指定できます。ボットが正しい項目に対応付けます。
  • スレッドで続ける。 一連の質問を続けるには、ボットを再度メンションします。
  • Markdown はそのまま機能します。 回答は各プラットフォーム向けに整形されます（太字、リスト、リンク、コード）。
  • 共有チャンネルは絞り込む。 #payments を決済チームに限定すれば、誤った回答が誤ったチャンネルに届くことはなくなります（チャンネルをチームやプロジェクトに絞る）。

次のステップ

  • MCP サーバー — AI エージェントや IDE を Archyl のツールに接続
  • Webhook 通知 — アーキテクチャイベントを外部システムに送信