feishu_mcp_create_doc

MCP を通じて create-doc を呼び出し、Lark-flavored Markdown コンテンツから新しい飞书云文档を作成します。

戻り値

ツール実行成功後、以下のフィールドを含む JSON オブジェクトが返されます：

• doc_id（string）：文書の一意識別子（token）、形式は doxcnXXXXXXXXXXXXXXXXXXX
• doc_url（string）：文書のアクセスリンク。ブラウザで直接開くことができます。形式は https://www.feishu.cn/docx/doxcnXXXXXXXXXXXXXXXXXXX
• message（string）：操作結果メッセージ（例：「文書の作成に成功しました」）

パラメータ

markdown（必須）

文書の Markdown コンテンツ。Lark-flavored Markdown 形式を使用します。

本ツール呼び出しの markdown コンテンツは、構造が明確で、スタイルが豊かで、可読性が高いものが望ましいです。callout ハイライトブロック、分栏、テーブルなどの機能を適切に使用し、画像と mermaid の挿入機能を活用して、テキストと画像を組み合わせたコンテンツを実現してください。

以下の原則に従う必要があります：

• 構造が明確：見出しレベルは 4 層以下で、Callout を使って重要情報を強調する
• 視覚的なリズム感：分割線、分栏、テーブルを使ってテキストの大きな塊を分割する
• テキストと画像の融合：プロセスとアーキテクチャは優先的に Mermaid/PlantUML で可視化する
• 控えめな空白：Callout は過度ではなく、太字は核となる単語のみを強調する

ユーザーが明確なスタイルやデザイン要件を持っている場合は、ユーザーの要件を優先してください。

重要な注意：

• 見出しの重複禁止：markdown コンテンツの冒頭に title と同じ 1 級見出しを書かないでください。title パラメータはすでに文書のタイトルであり、markdown は本文コンテンツから直接始まる必要があります
• 目次：飞书が自動生成するため、手動で追加する必要はありません
• Markdown の構文は Lark-flavored Markdown 仕様に準拠する必要があります。詳しくは以下の「コンテンツ形式」を参照してください
• 長い文書を作成する場合、update-doc の追記モードを組み合わせて段階的に作成することを強くお勧めします。これにより成功率が向上します。

title（オプション）

文書のタイトル。

folder_token（オプション）

親フォルダの token。指定しない場合、文書はユーザーの個人スペースのルートディレクトリに作成されます。

folder_token は飞书フォルダの URL から取得できます。形式は https://xxx.feishu.cn/drive/folder/fldcnXXXX です。ここで fldcnXXXX が folder_token です。

wiki_node（オプション）

ナレッジベースノードの token または URL（オプション。指定された場合はそのノードの下に文書を作成します。folder_token および wiki_space と相互に排他的です）

wiki_node は飞书ナレッジベースページの URL から取得できます。形式は https://xxx.feishu.cn/wiki/wikcnXXXX です。ここで wikcnXXXX が wiki_node token です。

wiki_space（オプション）

ナレッジスペース ID（オプション。指定された場合はそのスペースのルートディレクトリに文書を作成します。特別な値 my_library はユーザーの個人ナレッジベースを表します。wiki_node および folder_token と相互に排他的です）

wiki_space はナレッジスペース設定ページの URL から取得できます。形式は https://xxx.feishu.cn/wiki/settings/7448000000000009300 です。ここで 7448000000000009300 が wiki_space ID です。

パラメータの優先度：wiki_node > wiki_space > folder_token

例

例 1：シンプルな文書を作成する

{
  "title": "プロジェクト計画",
  "markdown": "## プロジェクト概要\n\nこれは新しいプロジェクトです。\n\n### 目標\n\n- 目標 1\n- 目標 2"
}

例 2：指定したフォルダに作成する

{
  "title": "会議議事録",
  "folder_token": "fldcnXXXXXXXXXXXXXXXXXXXXXX",
  "markdown": "## 週間会議 2025-01-15\n\n### 討議事項\n\n1. プロジェクト進捗\n2. 来週の計画"
}

例 3：飞书拡張構文を使用する

ハイライトブロック、テーブルなど飞书の特有機能を使用：

{
  "title": "プロダクト要件",
  "markdown": "<callout emoji=\"💡\" background-color=\"light-blue\">\n重要な要件説明\n</callout>\n\n## 機能リスト\n\n<lark-table header-row=\"true\">\n| 機能 | 優先度 |\n|------|--------|\n| ログイン | P0 |\n| エクスポート | P1 |\n</lark-table>"
}

例 4：ナレッジベースノードの下に作成する

{
  "title": "技術ドキュメント",
  "wiki_node": "wikcnXXXXXXXXXXXXXXXXXXXXXX",
  "markdown": "## API インターフェース説明\n\nこれはナレッジベースの文書です。"
}

例 5：ナレッジスペースのルートディレクトリに作成する

{
  "title": "プロジェクト概要",
  "wiki_space": "7448000000000009300",
  "markdown": "## プロジェクト概要\n\nこれはナレッジスペースのルートディレクトリ下のレベル 1 文書です。"
}

例 6：個人ナレッジベースに作成する

{
  "title": "学習ノート",
  "wiki_space": "my_library",
  "markdown": "## 学習ノート\n\nこれは個人ナレッジベースに作成された文書です。"
}

コンテンツ形式

文書コンテンツは Lark-flavored Markdown 形式を使用します。これは標準 Markdown の拡張版で、飞书文書のすべてのブロック型と豊富なテキスト形式に対応しています。

一般的なルール

• 標準 Markdown 構文を基礎として使用
• カスタム XML タグを使用して飞书独自の機能を実装します（具体的なタグは各機能セクションを参照）
• 特殊文字を表示する場合はバックスラッシュでエスケープします：* ~ $ [ ] < > { } | ^`

---

📝 基本的なブロック型

テキスト（段落）

通常のテキスト段落

段落内の**太字**

複数の段落は空行で区切ります。

中央揃えテキスト {align="center"}
右揃えテキスト {align="right"}

段落の配置：{align="left|center|right"} 構文に対応しています。色と組み合わせることもできます：{color="blue" align="center"}

見出し

飞书は 9 級の見出しに対応しています。H1-H6 は標準 Markdown 構文を使用し、H7-H9 は HTML タグを使用します：

# 1 級見出し
## 2 級見出し
### 3 級見出し
#### 4 級見出し
##### 5 級見出し
###### 6 級見出し
<h7>7 級見出し</h7>
<h8>8 級見出し</h8>
<h9>9 級見出し</h9>

# 色付き見出し {color="blue"}
## 赤色見出し {color="red"}
# 中央揃え見出し {align="center"}
## 青色中央揃え見出し {color="blue" align="center"}

見出し属性：{color="色名"} および {align="left|center|right"} 構文に対応し、組み合わせて使用できます。色の値：red, orange, yellow, green, blue, purple, gray。この機能は慎重に使用してください。

リスト

有序リスト、無序リストは tab またはスペース 2 個でネストします

- 無序項目 1
  - 無序項目 1.a
  - 無序項目 1.b

1. 有序項目 1
2. 有序項目 2

- [ ] 待機中
- [x] 完了

引用ブロック

> これは引用です
> 複数行にわたることができます

> 引用内では**太字**と*斜体*などの形式に対応しています

コードブロック

⚠️ フェンス付きコードブロック（```）のみに対応しており、インデント形式のコードブロックには対応していません。

```python
print("Hello")
```

対応言語：python, javascript, go, java, sql, json, yaml, shell など。

区切り線

---

---

🎨 豊富なテキスト形式

テキストスタイル

**太字** *斜体* ~~打消し線~~ `インラインコード` <u>下線</u>

テキストカラー

<text color="red">赤色</text> <text background-color="yellow">黄色背景</text>

対応色：red, orange, yellow, green, blue, purple, gray

リンク

[リンク文字](https://example.com) （アンカーリンクは非対応）

インライン公式（LaTeX）

$E = mc^2$（$ の前後にスペースが必要）または <equation>E = mc^2</equation>（制限なし、推奨）

---

🚀 高度なブロック型

ハイライトブロック（Callout）

<callout emoji="✅" background-color="light-green" border-color="green">
**書式設定**に対応したコンテンツで、複数のブロックを含めることができます
</callout>

属性：emoji （✅ ⚠️ 💡 などの emoji 文字を使用）、background-color、border-color、text-color

背景色：light-red/red, light-blue/blue, light-green/green, light-yellow/yellow, light-orange/orange, light-purple/purple, pale-gray/light-gray/dark-gray

よく使う例：💡light-blue（ヒント） ⚠️light-yellow（警告） ❌light-red（危険） ✅light-green（成功）

制限：callout サブブロックはテキスト、見出し、リスト、待機リスト、引用のみ対応。コードブロック、テーブル、画像は非対応です。

分栏（Grid）

対比や並列表示に適しています。2～5 列に対応：

2 栏（等幅）

<grid cols="2">
<column>

左栏内容

</column>
<column>

右栏内容

</column>
</grid>

3 栏カスタム幅

<grid cols="3">
<column width="20">左栏(20%)</column>
<column width="60">中栏(60%)</column>
<column width="20">右栏(20%)</column>
</grid>

属性：cols（列数 2-5）、width（列幅パーセンテージ、合計 100。等幅の場合は省略可）

テーブル

標準 Markdown テーブル

| 列 1 | 列 2 | 列 3 |
|------|------|------|
| セル 1 | セル 2 | セル 3 |
| セル 4 | セル 5 | セル 6 |

飞书拡張テーブル

セルが複雑なコンテンツ（リスト、コードブロック、ハイライトブロックなど）を必要とする場合に使用します。

層次構造（厳密に従う必要があります）：

<lark-table>                    ← テーブルコンテナ
  <lark-tr>                     ← 行（直接の子要素は lark-tr のみ）
    <lark-td>コンテンツ</lark-td>     ← セル（直接の子要素は lark-td のみ）
    <lark-td>コンテンツ</lark-td>     ← 各行の lark-td の数は同じである必要があります
  </lark-tr>
</lark-table>

属性：

• column-widths：列幅。ピクセル値をカンマで区切る。合計幅≈730
• header-row：最初の行がヘッダーかどうか（"true" または "false"）
• header-column：最初の列がヘッダーかどうか（"true" または "false"）

セル書き方：コンテンツの前後に空行が必要

<lark-td>

ここにコンテンツを書きます

</lark-td>

完全な例（2 行 3 列）：

<lark-table column-widths="200,250,280" header-row="true">
<lark-tr>
<lark-td>

**ヘッダー1**

</lark-td>
<lark-td>

**ヘッダー2**

</lark-td>
<lark-td>

**ヘッダー3**

</lark-td>
</lark-tr>
<lark-tr>
<lark-td>

通常のテキスト

</lark-td>
<lark-td>

- リスト項目1
- リスト項目2

</lark-td>
<lark-td>

コード内容

</lark-td>
</lark-tr>
</lark-table>

制限：セル内は Grid とネストテーブルに非対応

セル結合：読み込み時に rowspan/colspan 属性を返します。作成時は非対応

禁止：

• Markdown テーブル構文（|---|）の混用
• <br/> での改行
• <lark-td> タグの省略

画像

<image url="https://example.com/image.png" width="800" height="600" align="center" caption="画像説明テキスト"/>

属性：url （必須。システムが自動的にダウンロードしてアップロード）、width、height、align （left/center/right）、caption

⚠️ 重要：token 属性の直接使用（例：<image token="xxx"/>）には非対応です。URL 方式のみ対応しています。システムが自動的に画像をダウンロードして飞书にアップロードします。

PNG/JPG/GIF/WebP/BMP に対応。最大 10MB

画像/ファイル挿入方式の選択：

• 公開アクセス可能な画像 URL がある → create-doc / update-doc の markdown で直接 <image url="..."/> を使用すれば一度に完了

• ローカル画像またはファイル（ユーザーがチャットで送信した画像/ファイルなど） → 先に create-doc / update-doc で文書のテキストコンテンツを作成または更新し、次に feishu_doc_media ツールを使ってローカルの画像またはファイルを文書の末尾に追加します。メディアを文書内の特定の位置に表示する必要がある場合は、まず create-doc で前のコンテンツを作成し、feishu_doc_media を呼び出して画像/ファイルを追加してから、最後に update-doc の 追記モードで後続コンテンツを追加します

ファイル

<file url="https://example.com/document.pdf" name="ドキュメント.pdf" view-type="1"/>

属性：

• url （ファイル URL、必須。システムが自動的にダウンロードしてアップロード）
• name （ファイル名、必須）
• view-type （1=カードビュー、2=プレビュービュー、オプション）

⚠️ 重要：token 属性の直接使用（例：<file token="xxx"/>）には非対応です

ボード（Mermaid / PlantUML チャート）

2 種類のチャート構文に対応しています：Mermaid と PlantUML。

Mermaid チャート

チャート優先選択はこの形式です。mermaid チャートは可視化ボードに描画されます。mermaid で実装できるチャートは mermaid を優先選択すべきです。

```mermaid
graph TD
    A[開始] --> B{判定}
    B -->|Yes| C[処理]
    B -->|No| D[終了]
```

対応チャート型：flowchart, sequenceDiagram, classDiagram, stateDiagram, gantt, mindmap, erDiagram

PlantUML チャート

PlantUML チャートは可視化ボードに描画されます。mermaid で満たせないシーンでは PlantUML で描画できます。

```plantuml
@startuml
Alice -> Bob: Hello
Bob --> Alice: Hi!
@enduml
```

対応チャート型：sequence, usecase, class, activity, component, state, object, deployment

ボードの読み込み

読み込み時に <whiteboard> タグを返します：

<whiteboard token="xxx" align="center" width="800" height="600"/>

属性：token （ボード識別子）、align （left/center/right）、width、height

重要な説明：

• create-doc の際は Mermaid/PlantUML コードブロックを使用します。システムが自動的にボードに変換されます。<whiteboard> 方式での記述は禁止です
• 読み込み時には token のみ取得できます。fetch-file ツールでコンテンツを確認できます。オリジナルソースコードは取得できません

多次元テーブル（Bitable）

<bitable view="table"/>
<bitable view="kanban"/>

属性：view （table/kanban、デフォルト table）

注意：token は読み込み専用属性です。作成時に指定することはできません。空の多次元テーブルのみ作成でき、作成後に手動でデータを追加します。

会話カード（ChatCard）

<chat-card id="oc_xxx" align="center"/>

属性：id （形式 oc_xxx、必須）、align （left/center/right）

埋め込み Web ページ（Iframe）

<iframe url="https://example.com/survey?id=123" type="12"/>

属性：url （必須）、type （コンポーネント型番号、必須）

type 列挙：1=Bilibili、2=西瓜、3=Youku、4=Airtable、5=Baidu Maps、6=Amap、8=Figma、9=Mockers、10=Canva、11=CodePen、12=飞书アンケート、13=金数据

重要な注意：上記にリストアップされた Web ページ型のみ対応しています。その他の型の Web ページは埋め込みに対応していません。iframe を使用しないでください。通常の Web ページリンクについては、Markdown リンク形式 [リンク文字](URL) を代わりに使用してください。

リンクプレビュー（LinkPreview）

<link-preview url="メッセージリンク" type="message"/>

属性：url （必須。属性のみ）、type （message=メッセージリンク）

現在はメッセージリンクのみ対応しており、読み込みのみ対応します。作成には非対応

引用コンテナ（QuoteContainer）

<quote-container>
引用コンテナのコンテンツ
</quote-container>

引用ブロックと異なり、引用コンテナはコンテナ型で複数のサブブロックを含めることができます

---

🔧 高度な機能ブロック

電子表計算（Sheet）

<sheet rows="5" cols="5"/>
<sheet/>

属性：rows （行数、デフォルト 3、最大 9）、cols （列数、デフォルト 3）

注意：token は読み込み専用属性です。作成時に指定することはできません。空の電子表計算のみ作成でき、作成後に Sheet API でデータを操作します。

読み込み専用ブロック型 🔒

以下のブロック型は読み込みのみ対応し、作成には非対応です：

ブロック型	タグ	説明
マインドマップノート	<mindnote token="xxx"/>	プレースホルダー情報のみ取得
フローチャート/UML	<diagram type="1"/>	type: 1=フローチャート、2=UML
AI テンプレート	<ai-template/>	コンテンツなしプレースホルダーブロック

タスクブロック

<task task-id="xxx" members="ou_123, ou_456" due="2025-01-01">タスクタイトル</task>

属性：task-id、members （メンバー ID リスト）、due （期限）

同期ブロック

<!-- ソース同期ブロック：コンテンツはサブブロック内 -->
<source-synced align="1">サブブロックコンテンツ...</source-synced>

<!-- 参照同期ブロック：ソース文書コンテンツを自動取得 -->
<reference-synced source-block-id="xxx" source-document-id="yyy">ソースコンテンツ...</reference-synced>

属性：source-synced は align を持つ；reference-synced は source-block-id、source-document-id を持つ

文書ウィジェット（AddOns）

<add-ons component-type-id="blk_xxx" record='{"key":"value"}'/>

属性：component-type-id （ウィジェット型 ID）、record （JSON データ）

複数の型を含みます：Q&A インタラクション、日付リマインダーなど。Mermaid などの一部コンポーネントはすでに board ブロックとして専用にカプセル化されています

旧版ウィジェット（ISV）

<isv id="comp_xxx" type="type_xxx"/>

属性：component_id、component_type_id

旧版オープンプラットフォームウィジェット。新版は AddOns を使用してください

Wiki サブディレクトリ（WikiCatalog）🕰️

<wiki-catalog token="wiki_xxx"/>

属性：wiki_token （ナレッジベースノード token）

🕰️ 旧版。新版の sub-page-list の使用をお勧めします

Wiki サブページリスト（SubPageList）

<sub-page-list wiki="wiki_xxx"/>

属性：wiki_token （現在のページの wiki token）

ナレッジベース文書作成時のみ対応。現在のページの wiki token を渡す必要があります

議事録（Agenda）

<agenda>
  <agenda-item>
    <agenda-title>議題タイトル</agenda-title>
    <agenda-content>議題コンテンツ</agenda-content>
  </agenda-item>
</agenda>

構造：agenda （コンテナ） → agenda_item （議題項目） → agenda_title （タイトル） + agenda_content （コンテンツ）

Jira イシュー（JiraIssue）

<jira-issue id="xxx" key="PROJECT-123"/>

属性：id （Jira イシュー ID）、key （Jira イシュー Key）

OKR シリーズ⚠️

<okr id="okr_xxx">
  <objective id="obj_1">
    <kr id="kr_1"/>
  </objective>
</okr>

⚠️ user_access_token でのみ作成に対応。OKR API を使用して詳細操作を行う必要があります

構造：okr → okr_objective （目標） → okr_key_result （重要結果） + okr_progress （進捗）

---

📎 メンション及び参照

ユーザーをメンション

<mention-user id="ou_xxx"/>

属性：id （ユーザーの open_id、形式 ou_xxx）

文書内で @張三 のような形式を直接書かないでください。search-user でユーザーの id を取得し、mention-user を使用してください。

文書をメンション

<mention-doc token="doxcnXXX" type="docx">文書タイトル</mention-doc>

属性：token （文書 token）、type （docx/sheet/bitable）

---

📅 日付と時刻

日付リマインダー（Reminder）

<reminder date="2025-12-31T18:00+08:00" notify="true" user-id="ou_xxx"/>

属性：

• date （必須）：YYYY-MM-DDTHH:mm+HH:MM、ISO 8601 タイムゾーンオフセット付き
• notify （true/false）：通知を送信するかどうか
• user-id （必須）：作成者ユーザー ID

---

📐 数学式

ブロックレベル公式（LaTeX）

$$
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

インライン公式

アインシュタイン方程式：$E = mc^2$（注意：$ の前後にスペースが必要。隣接する位置にスペースがあってはいけません）

---

✍️ 執筆ガイド

シーン別早見表

シーン	推奨コンポーネント	説明
重要な提示/警告	Callout	青色ヒント、黄色警告、赤色危険
対比/並列表示	Grid 分栏	2-3 列がベスト。Callout と組み合わせるとより強調
データ集計	テーブル	シンプルなら Markdown、複雑なネストなら lark-table
ステップ説明	有序リスト	サブステップをネストできます
タイムライン/バージョン	有序リスト + 太字日付	または Mermaid timeline を使用
コード表示	コードブロック	言語を注記。適切にコメントを追加
ナレッジカード	Callout + emoji	概念説明、ちょっとした情報に使用
引用説明	引用ブロック >	原文、名言を引用
用語対照表	2 列テーブル	中英文、省略形と正式名称など

---

🎯 ベストプラクティス

• 空行で分隔：異なるブロック型の間は空行で分隔
• 転送エスケープ：特殊文字は \ でエスケープ：\* \~ ```
• 画像：URL を使用。システムが自動的にダウンロードしてアップロード
• 分栏：列幅の合計は 100 である必要があります
• テーブル選択：シンプルデータは Markdown、複雑なネストは <lark-table>
• メンション：@ユーザーは <mention-user>、@文書は <mention-doc>
• 目次：飞书が自動生成するため、手動で追加する必要はありません

---

📖 補足説明

• 画像、ボード、多次元テーブルには token が必要です（URL は自動的にアップロードして変換されます）
• ユーザーをメンションし、会話カードを使用するには相応のアクセス権限が必要です
• 標準 Markdown と完全に互換性があります