LeafLoomヘルプセンター

Feishu・Lark と接続する

できること

外部で設定した lark-cli 経由でクラウド文書や Base を使います。

始める前に

公式 lark-cli・認可済みアカウント・練習用の文書を準備します。

操作手順

  1. 公式 lark-cli を別途インストール・設定・ログインしてください。認証情報は CLI が管理します。

  2. 設定 → AI 連携 → Feishu / Lark を開き、連携を有効にします。必要ならネイティブ実行ファイルのパスと CLI プロファイルを入力し、保存して 接続を検証 を選びます。パスは空欄で自動検出します。

  3. MCP アクセス権限 でローカル AI と Tunnel の Feishu 読み取り・書き込みを個別に許可します。初回のローカル有効化時に専用接続設定をコピーし、バックエンド更新後はクライアントのツール一覧を更新してください。

  4. AI にインストール済み CLI のヘルプと内蔵 Skill を確認させ、汎用の読み書きツールから文書・Base・その他の業務コマンドを利用します。ブロック編集は XML の見出しとリッチ構造に対応し、文書更新には読み取り時のリビジョンが必要です。アカウント検証は個別リソースへの権限を保証しません。

  5. 高リスクコマンドと raw API は、ローカル/Tunnel 別の高リスク許可(初期値オフ)と操作ごとの明示的な確認が必要です。読み取り・書き込みを無効にすると高リスク許可も解除されます。

  6. 添付は一時ファイル ID を使って分割アップロード/ダウンロードします。接続フォルダーの既存ファイルを取り込む場合はノート読み取り権限も必要です。更新後はツール一覧を再取得してください。従来の文書/Base 用の四つのツールは CLI 検索・汎用読み書き・ファイル転送に置き換わりました。

同じ Tunnel の会話は、その接続に設定された権限を共有します。ランタイムの内部認証は会話の接続トークンと分離され、会話を切り替えても権限の更新や再接続は不要です。リソース権限を無効にすると、アクセスは直ちに失効します。

Dev とインストール版は Tunnel 設定とライフサイクルを共有し、有効時はアプリ起動で接続し、終了で停止します。Dev は既存インストールのランタイムを再利用します。同じ接続の standalone tunnel-client を別に起動しないでください。MCP 認証エラーの leafloom_mcp は Feishu の再認証を必要としません。Base はテーブル一覧の実際の ID を使い、URL の未確認の table パラメーターをそのまま使わないでください。

CLI 未検出・非対応、未設定、未ログイン、期限切れ、ネットワーク障害を区別します。外部で設定や再認可を行って再検証してください。クラウド操作には接続が必要で、要求された内容は呼び出し元 AI に返されます。ローカル知識ベースへの自動取り込み・索引化は行いません。機能と制限をご覧ください。

完了後の状態

接続状態と権限は別に表示され、クラウドの内容が自動でローカルメモになることはありません。

うまくいかないとき

ログイン確認は各資料への権限保証ではありません。タイムアウトや部分成功後は結果を読んでから判断します。

次のステップ

GitHub で原文を見る ↗