snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ja/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: AIエージェント
+description: AI機能を自動化ワークフローに直接統合します。
+---
+
+## 概要
+
+AI の機能を自動化ワークフローに直接統合し、インテリジェントなデータ処理と意思決定を実現します。
+
+## 機能
+
+| 機能            | 説明                          |
+| ------------- | --------------------------- |
+| **AI アクション**  | あらゆるワークフローに AI を活用したステップを追加 |
+| **データ強化**     | 外部データでレコードを自動的に補完する         |
+| **分類**        | 内容分析に基づいてレコードを分類する          |
+| **要約**        | テキストフィールドから要約を生成する          |
+| **カスタムプロンプト** | AI がデータをどのように処理するかを正確に定義する  |
+
+## ユースケース
+
+* **リードスコアリング**: インバウンドリードに自動でスコアを付け、優先順位を付ける
+* **データクレンジング**: 企業名と連絡先情報を標準化する
+* **メールの下書き**: 議事録に基づいてフォローアップメールの下書きを生成する
+* **レコードのルーティング**: 内容に基づいて適切なチームメンバーにレコードを割り当てる
+
+## 関連
+
+* [ワークフローの概要](/l/ja/user-guide/workflows/overview) — 自動化の基本
+* [AI 権限](/l/ja/user-guide/ai/capabilities/permissions-access-control) — AI エージェントのアクセス制御

packages/twenty-docs/l/ja/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: AI チャットボット
+description: 自然言語でCRMデータとやり取りできるインテリジェントなアシスタントです。
+---
+
+## 概要
+
+自然言語で質問をすると、アシスタントがCRMデータを取得して説明します。
+
+## 機能
+
+| 機能              | 説明                                                     |
+| --------------- | ------------------------------------------------------ |
+| **自然言語クエリ**     | フィルターを作成する代わりに、平易な英語で質問できます                            |
+| **データへのフルアクセス** | ワークスペース全体にわたり、レコード、リレーションシップ、指標に対してクエリを実行できます          |
+| **ページコンテキスト**   | 現在の表示に基づいて、"this company" や "this opportunity" を参照できます |
+| **会話型**         | 追加の質問でも前のクエリのコンテキストを維持します                              |
+
+## 会話例
+
+### レコードの検索
+
+* "5万ドルを超える商談をすべて表示して"
+* "過去2週間メールしていない連絡先を検索して"
+* "ヘルスケア業界の企業を一覧表示して"
+
+### インサイトを得る
+
+* "パイプラインの合計金額は？"
+* "先月クローズした商談は何件？"
+* "どのステージで停滞している商談が最も多い？"
+
+### ページコンテキストを活用する
+
+* "この人とのやり取りを要約して" (連絡先ページで)
+* "どの商談がこの会社に関連付けられていますか？" (会社ページで)
+* "この商談の最終更新はいつ？" (商談ページで)

packages/twenty-docs/l/ja/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: MCP サーバー
+description: Model Context Protocol を使用して、AI アシスタントを Twenty ワークスペースに接続します。
+---
+
+Twenty は [MCP](https://modelcontextprotocol.io/) サーバーを公開し、Claude Desktop、Claude Code、Cursor、ChatGPT などの AI アシスタントが自然言語で CRM データを読み書きできるようにします。
+
+MCP エンドポイントとして、あなたの**ワークスペース URL**（Twenty にアクセスするために使用している URL）を使用します。 Twenty Cloud では、ワークスペース URL は `https://{mycompany}.twenty.com` またはカスタムドメインの場合があります。 サーバーは次の場所で利用できます:
+
+| 環境         | MCP エンドポイント                                                                |
+| ---------- | -------------------------------------------------------------------------- |
+| **クラウド**   | `https://{your-workspace-url}/mcp` (例: `https://mycompany.twenty.com/mcp`) |
+| **セルフホスト** | `https://{your-domain}/mcp`                                                |
+
+## 認証方法
+
+MCP クライアントの認証方法は 2 つあります: **OAuth**（推奨）または **API Key**。
+
+### オプション A — OAuth（推奨）
+
+OAuth を使用すると、MCP クライアントがログイン用のブラウザーウィンドウを開きます。 シークレットは設定ファイルに保存されず、トークンは自動的に更新されます。
+
+<Note>
+OAuth を利用するには、[MCP Authorization 仕様](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization)をサポートする MCP クライアントが必要です。 Claude Desktop、Claude Code、Cursor、ChatGPT が対応しています。
+</Note>
+
+MCP クライアントの設定に次を追加し、`{your-workspace-url}` をワークスペースのホスト（例: `mycompany.twenty.com`）に置き換えてください:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+以上です — API キーは不要です。 クライアントが初回接続する際には、次を実行します:
+
+1. `/.well-known/oauth-protected-resource` および `/.well-known/oauth-authorization-server` を通じて Twenty の OAuth メタデータを検出する
+2. 動的クライアント登録（RFC 7591）を通じて自らを OAuth クライアントとして登録する
+3. アクセスを許可するためにブラウザーを開く
+4. トークンを受け取り、MCP サーバーに接続する
+
+以後の接続では保存済みトークンを再利用し、自動で更新します。
+
+### オプション B — API キー
+
+MCP クライアントが OAuth をサポートしていない場合、または固定認証情報を好む場合は、`Authorization` ヘッダーに API キーを渡してください:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+API キーはワークスペース データへのアクセスを許可します。 バージョン管理や共有のドットファイルには含めないでください。
+</Warning>
+
+API キーを作成するには、**Settings → MCP & APIs → API → + Create key** に移動します。 詳細は[API](/l/ja/developers/extend/api#create-an-api-key)を参照してください。
+
+## クイックスタート
+
+### 1. 構成をコピー
+
+Twenty で **Settings → MCP & APIs → MCP** に移動します。 認証方法（OAuth または API Key）を選択し、JSON スニペットをコピーして（ワークスペース URL は既に反映されています）、MCP クライアントの設定ファイルに貼り付けます。
+
+| クライアント             | 設定ファイルの場所                                                                                                                                           |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                |
+| **Claude Code**    | `~/.claude.json` (ユーザー) または `.mcp.json` (プロジェクト)                                                                                                    |
+| **Cursor**         | プロジェクト内では `.cursor/mcp.json`、グローバルでは `~/.cursor/mcp.json`                                                                                           |
+| **ChatGPT**        | **Settings → Apps & Connectors → Advanced settings** で Developer Mode を有効にし、その後 **Settings → Apps & Connectors** の **Create** を使用して MCP サーバーを追加します。 |
+
+### 2. 接続
+
+MCP クライアントを再起動します（または設定を再読み込みします）。 OAuth を使用している場合、アクセス許可のために Twenty にリダイレクトされます。 API キーを使用する場合は、すぐに接続されます。
+
+### 3. 使い始める
+
+AI アシスタントに CRM とやり取りするよう依頼してください:
+
+* *"最近作成された企業を5件表示して"*
+* *"Acme Corp に Jane Doe という名前の新しい連絡先を作成して"*
+* *"$10k を超える金額のオープンな商談をすべて見つけて"*
+
+## 利用可能なツール
+
+接続されると、MCP サーバーは Twenty API を反映したツールを公開します。 推奨されるワークフローは次のとおりです:
+
+1. **`learn_tools`** — 特定のツールの入力スキーマを取得する
+2. **`execute_tool`** — ツールを実行する
+
+ツール名を覚えておく必要はありません。 AI アシスタントにできることを尋ねると、自動的に `learn_tools` を呼び出します。
+
+## 権限
+
+MCP 接続は、認証済みユーザー（OAuth）の権限、または API キーに割り当てられたロールを継承します。 MCP サーバーが実行できる操作を制限するには:
+
+* **OAuth**: ユーザーのワークスペース ロールが適用されます。
+* **API Key**: **Settings → Members → Roles** で API キーにロールを割り当てます。 詳しくは[権限](/l/ja/user-guide/permissions-access/capabilities/permissions)を参照してください。
+
+## セルフホスト構成
+
+セルフホストのインスタンスでは、`{your-workspace-url}` をサーバーの URL に置き換えてください。 環境の `SERVER_URL` が Twenty インスタンスの公開 URL と一致していることを確認してください — これは OAuth のディスカバリ メタデータの生成に使用されます。
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+MCP エンドポイント、OAuth エンドポイント、およびディスカバリ メタデータはすべてこの値から導出されます。
+
+## トラブルシューティング
+
+**"Unauthorized" または 401 エラー**
+
+* OAuth: MCP クライアントで保存済みトークンをクリアして再接続し、再認可します。
+* API Key: キーが有効で、有効期限切れでないことを確認します。 必要に応じて再生成してください。
+
+**OAuth フローでブラウザーが開かない**
+
+* MCP クライアントが MCP Authorization をサポートしていることを確認してください。 サポートしていない場合は API Key の方法に切り替えてください。
+
+**接続タイムアウト**
+
+* MCP エンドポイントの URL にあなたのマシンから到達できることを確認してください。 セルフホストのインスタンスでは、サーバーが稼働していることと `SERVER_URL` が正しく設定されていることを確認してください。

packages/twenty-docs/l/ja/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: 権限とアクセス制御
+description: AI エージェントがワークスペース内でアクセスおよび変更できる内容を制御します。
+---
+
+## 概要
+
+AI エージェントは既存の権限構造に従います。 これは、ワークスペース内で自動化された AI プロセスがアクセスまたは変更できる範囲を厳密に管理したいチームにとって特に重要です。
+
+## AI エージェントに役割を割り当てる
+
+1. **設定 → メンバー → 役割** に移動します
+2. 割り当てたい役割をクリック
+3. **割り当て** タブを開く
+4. 「**AI Agents**」で、**+ Assign to AI agent** をクリックします
+5. リストから AI エージェントを選択
+6. 割り当てを確認する
+
+## AI エージェントに役割を割り当てる理由
+
+| 利点           | 説明                             |
+| ------------ | ------------------------------ |
+| **セキュリティ**   | AI エージェントがアクセスまたは変更できるデータを制限する |
+| **コンプライアンス** | AI が必要なデータのみを処理するようにする         |
+| **制御**       | AI 自動化による意図しない操作を防止する          |
+| **監査可能性**    | どのエージェントがどの操作を実行したかを追跡する       |
+
+<Note>
+ワークフロー内で実行される AI エージェントの場合、役割の割り当てにより、ワークフローにより広い権限がある場合でも、エージェントが意図された範囲外のデータにアクセスしたり変更したりできないようにします。
+</Note>
+
+## 関連
+
+* [権限](/l/ja/user-guide/permissions-access/capabilities/permissions) — 役割の作成と管理に関する詳細情報
+* [AI エージェント](/l/ja/user-guide/ai/capabilities/ai-agents) — ワークフローにおける AI 機能

packages/twenty-docs/l/ja/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: AI FAQ
+description: Twenty の AI 機能に関するよくある質問。
+---
+
+<AccordionGroup>
+
+  <Accordion title="どのようなAI機能が利用できますか？">
+    AIには主に次の2つの機能があります。
+
+    1. **AI Chatbot**: 20 のデータにアクセスし、クエリをサポートするコンテキスト認識アシスタント
+    2. **ワークフローのAIエージェント**：ワークフロー内でデータの処理、意思決定、タスクの実行を行うインテリジェントな自動化。
+  </Accordion>
+
+  <Accordion title="AIエージェントは、私のすべてのデータにアクセスできますか？">
+    AIエージェントは、許可システムの下で動作します。 **設定 → メンバー → ロール** で AIエージェントに特定のロールを割り当て、アクセスできるデータと実行できるアクションを完全に制御できます。
+  </Accordion>
+
+  <Accordion title="AIクレジットはどのように機能しますか？">
+    AIアクションは、タスクの複雑さと使用するAIモデルに基づいてワークフロークレジットを消費します。
+  </Accordion>
+
+  <Accordion title="自分のAIモデルを使用できますか?">
+    クラウド環境では、Twentyが提供するAIモデルのみを使用できます。 自己ホスト型インスタンスでは、Organizationライセンスを取得した後に独自のAIモデルを使用できます。
+  </Accordion>
+
+  <Accordion title="AIエージェントに割り当てられた役割は見当たりませんが、どこにありますか?">
+    既定では、ロール一覧はワークスペースメンバーに割り当て可能なロールに絞り込まれています。 役割がAIエージェントのみに割り当てられる場合は、AIエージェントの役割を含めるようにフィルタを変更する必要があります。
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/ja/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: AI
+description: Twenty の AI搭載機能。
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="AI" />
+</Frame>
+
+## 機能
+
+現在、Twenty では次の機能を提供しています：
+
+### 1. AI チャットボット
+
+コンテキストを理解し、Twenty のすべてのデータにアクセスできる会話型アシスタントです。
+
+**主な機能：**
+
+* **完全なデータアクセス**：ワークスペース内のあらゆるレコード、リレーションシップ、メトリクスをクエリできます
+* **ページコンテキストの認識**：Twenty 内の表示場所に基づいて "this company" や "this opportunity" を参照できます
+* **自然言語**：メニューを操作せずに質問し、回答を得られます
+
+**プロンプト例：**
+
+* "今月クローズ予定の商談はどれですか？"
+* "「Negotiation」に30日以上留まっている商談はどれですか？"
+* "この人とのやり取りを要約して"
+
+### 2. ワークフローにおける AI エージェント
+
+AI アクションと自律型エージェントでワークフローを拡張します。
+
+**主な機能：**
+
+* **AI アクション**：AI を使用してデータの充実化、レコードの分類、要約の生成などを行います
+* **自律型エージェント**：ワークフロー内で複数ステップのタスクをエージェントに実行させます
+* **カスタムプロンプト**：AI がデータをどのように処理すべきかを正確に定義します
+
+**ユースケース：**
+
+* インバウンドリードを自動分類する
+* 公開情報から企業データを充実させる
+* 議事録に基づいてフォローアップメールの下書きを生成する
+* エンゲージメントのパターンに基づいて商談をスコアリングする
+
+## 権限とアクセス制御
+
+AI エージェントは既存の権限システムを通じて管理されます：
+
+1. **設定 → メンバー → 役割** に移動します
+2. 各 AI エージェントがアクセスできるデータを設定する
+3. オブジェクトごとに読み取り/書き込み権限を設定する
+
+これにより、AI エージェントがデータガバナンスポリシーを遵守し、必要なものにのみアクセスすることを保証します。
+
+* 開発の最新情報は私たちの[GitHub](https://github.com/twentyhq/twenty)をフォローしてください
+* フィードバックや機能リクエストを共有するには、私たちの[Discord](https://discord.gg/UfGNZJfAG6)に参加してください