Lark MCP

⚠️ 重要な注意事項

ドキュメント/ナレッジベース検索には OAuth 設定が必須です：

• docx_builtin_search → --oauth が必要
• wiki_v1_node_search → --oauth が必要

設定しない場合、エラー 99991663 が返されます。設定方法は installation.md を参照してください。

---

コアルール

# ツール命名（ハイフン、アンダースコア不可）
✅ mcp__lark-mcp__tool_name
❌ mcp__lark_mcp__tool_name

# パラメータ構造
path: {app_token, table_id}   # URL パスパラメータ
params: {page_size, ...}      # クエリパラメータ
data: {fields, ...}           # リクエストボディ
useUAT: false                 # true=ユーザーアイデンティティ, false=テナントアイデンティティ

よくある落とし穴

# content は JSON 文字列である必要があります
❌ content: {"text": "hello"}
✅ content: '{"text": "hello"}'

# フィルタ条件の value は配列である必要があります
❌ value: "已完成"
✅ value: ["已完成"]

# グループ作成時は owner_id を指定する必要があります。指定しないとグループ所有者がボットになります
owner_id: "ou_xxxxx"

# パラメータ名の違い
docx_builtin_search: search_key  # query ではありません
wiki_v1_node_search: query       # search_key ではありません

# トークンの種類
wiki_v2_space_getNode: wikcn... を使用  # doxcn... は使用不可
docx_v1_document_rawContent: doxcn... を使用

useUAT の選択

シーン	useUAT
リソース作成（ユーザーがアクセス可能にしたい）	true
ドキュメント/ナレッジベース検索	true
ユーザープライベートデータへのアクセス	true
パブリックデータの照会	false

ツールクイックリファレンス

カテゴリ	ツール	ドキュメント
メッセージ	im_v1_message_create, im_v1_message_list	im.md
グループ	im_v1_chat_create, im_v1_chat_list, im_v1_chatMembers_get	chat.md
マルチディメンションテーブル	bitable_v1_app_create, bitable_v1_appTableRecord_search/create/update	bitable.md
ドキュメント	docx_builtin_search, docx_v1_document_rawContent, docx_builtin_import	documents.md
ナレッジベース	wiki_v1_node_search, wiki_v2_space_getNode	wiki.md

ID タイプ

プレフィックス	タイプ	ソース
ou_	ユーザー ID	API 戻り値
oc_	グループチャット ID	im_v1_chat_list
bascn	マルチディメンションテーブル	URL の base/ の後
tbl	データテーブル	URL パラメータ table=
doxcn	ドキュメント	検索結果または URL
wikcn	ナレッジベースノード	ナレッジベース URL

クイック例

# メッセージ送信
ツール: mcp__lark-mcp__im_v1_message_create
data:
  receive_id: "oc_xxxxx"
  msg_type: "text"
  content: '{"text": "メッセージ内容"}'
params:
  receive_id_type: "chat_id"

# グループ作成
ツール: mcp__lark-mcp__im_v1_chat_create
data:
  name: "グループ名"
  chat_mode: "group"
  owner_id: "ou_xxxxx"
  user_id_list: ["ou_xxxxx"]
params:
  user_id_type: "open_id"

# マルチディメンションテーブルレコード作成
ツール: mcp__lark-mcp__bitable_v1_appTableRecord_create
path:
  app_token: "bascnxxxxxx"
  table_id: "tblxxxxxx"
data:
  fields:
    テキストフィールド: "値"
    単一選択フィールド: "オプション名"
useUAT: true

# ドキュメント検索
ツール: mcp__lark-mcp__docx_builtin_search
data:
  search_key: "キーワード"
  count: 10
useUAT: true

エラークイックリファレンス

エラー	原因	解決方法
tool not found	サーバー名エラー	mcp__lark-mcp__ プレフィックスを使用
99991663	権限不足	useUAT: true にするか OAuth を設定
131005 not found	トークンタイプエラー	wikcn と doxcn のどちらを使うか確認
リソース作成後アクセス不可	テナントアイデンティティで作成	useUAT: true を使用
field not found	フィールド名エラー	appTableField_list で確認
invalid content	フォーマットエラー	content をシングルクォートで JSON をラップ

詳細ドキュメント: troubleshooting.md | installation.md