データのインポートとエクスポート

Elftia はさまざまなデータ形式のインポートとエクスポートに対応しており、デバイス間でのデータ移行、設定のバックアップ、他のユーザーとの設定共有を簡単に行えます。

インポート / エクスポートできるデータの種類

データの種類	エクスポート形式	エクスポート場所	インポート方法
LLM プロバイダー設定	JSON	設定 → プロバイダー設定	設定 → プロバイダー設定
MCP サーバー設定	JSON	設定 → MCP	設定 → MCP
Agent 定義	Markdown (.md)	Agent ページ	Agent ページ
キャラクターカード	PNG（メタデータ付き）/ JSON	ロールプレイ設定	ロールプレイ設定
チャット履歴	JSON	サイドバーの右クリックメニュー	サイドバーでインポート
テーマ設定	JSON	設定 → 外観	設定 → 外観
診断情報	JSON / ZIP	設定 → システム	インポート非対応

LLM プロバイダー設定

プロバイダー設定をエクスポートする

複数の LLM プロバイダーを設定したら、すべての設定を JSON ファイルとしてエクスポートし、バックアップや移行に利用できます。

1. 設定 → プロバイダー設定 を開きます。
2. プロバイダー一覧の上にある エクスポート ボタンをクリックします。
3. 保存先を選択します。ファイルは JSON 形式で保存されます。

エクスポートされた JSON には次の内容が含まれます。

• プロバイダー ID と名前
• Base URL 設定
• 有効化状態
• モデル一覧とパラメーター設定

注意

セキュリティ上の理由により、エクスポートされた設定には API Keys が 含まれません。インポート後に、各プロバイダーの API Key を再入力する必要があります。

プロバイダー設定をインポートする

1. 設定 → プロバイダー設定 を開きます。
2. プロバイダー一覧の上にある インポート ボタンをクリックします。
3. 以前にエクスポートした JSON ファイルを選択します。
4. システムにインポートのプレビューが表示されます。確認して設定を適用します。
5. 各プロバイダーの API Key を再入力し、接続をテストします。

MCP サーバー設定

MCP 設定をエクスポートする

1. 設定 → MCP（または機能レール内の MCP ページ）を開きます。
2. MCP サーバー一覧でエクスポート機能を探します。
3. 設定は、すべての MCP サーバー接続情報を含む JSON 形式で保存されます。

MCP 設定をインポートする

Elftia は、標準の MCP 設定 JSON ファイルからサーバー定義をインポートできます。

1. MCP 管理ページを開きます。
2. Import JSON ボタンをクリックします。
3. MCP 設定 JSON ファイルを選択します。形式の例:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@my-org/my-mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

4. システムが設定を解析し、設定内で定義された MCP サーバーを追加します。

ヒント

Elftia は Claude Desktop 形式の MCP 設定ファイル（claude_desktop_config.json）と互換性があり、直接インポートできます。

Agent 定義

Agent をエクスポートする

Agent 定義は Markdown ファイルとして保存されており、直接エクスポートできます。

1. Agent ページ を開きます。
2. エクスポートする Agent を選択します。
3. エクスポート機能を使用して、Agent 定義を .md ファイルとして保存します。

Agent の Markdown ファイルには次の内容が含まれます。

• Agent の名前と説明
• システムプロンプト
• ツール権限設定
• MCP サーバーの割り当て
• その他の動作設定

Agent をインポートする

1. Agent ページ を開きます。
2. 作成ボタンの横にあるインポートオプションをクリックします。
3. Agent の .md ファイルを選択します。
4. システムがファイルを解析し、対応する Agent を作成します。

キャラクターカード

Elftia は標準的なキャラクターカード形式に対応しており、一般的なコミュニティのキャラクターカード仕様と互換性があります。

キャラクターカードをエクスポートする

1. ロールプレイチャットで、RP 設定パネルを開きます。
2. キャラクターカードのエクスポート機能を探します。
3. エクスポート形式を選択します。
   • PNG（推奨）: PNG テキストチャンクにメタデータを埋め込んだ画像ファイルです。完全なキャラクター情報を含んだまま、画像として直接共有できます。
   • JSON: すべてのキャラクター定義データを含むプレーンテキスト形式です。

キャラクターカードをインポートする

1. ロールプレイ設定で Import Character Card をクリックします。
2. PNG または JSON 形式のキャラクターカードファイルを選択します。
3. システムがキャラクター情報を自動的に解析し、フォームに入力します。
4. インポート後にキャラクター設定を変更してから保存できます。

チャット履歴

チャットをエクスポートする

1. サイドバーで、エクスポートするチャットを右クリックします。
2. エクスポート を選択します。
3. 保存先を選択します。チャットは JSON 形式で保存されます。

エクスポートされたチャットには次の内容が含まれます。

• すべてのメッセージ（ユーザーメッセージと AI の返信）
• ブランチ情報
• メッセージのタイムスタンプ
• 使用されたモデル情報
• 添付ファイルの参照情報

一括エクスポート

1. サイドバーで一括選択モードに入ります。
2. 複数のチャットを選択します。
3. 一括操作バーのエクスポート機能を使用して、選択したすべてのチャットを一度にエクスポートします。

チャットをインポートする

1. サイドバーでインポート機能を使用します。
2. 以前にエクスポートしたチャット JSON ファイルを選択します。
3. チャットがセッション一覧に復元されます。

テーマ設定

テーマをエクスポートする

テーマモード、アクセントカラー、フォント、壁紙、カスタム CSS などを含むテーマ設定をカスタマイズし、その内容を保存したい場合は、テーマ設定ファイルとしてエクスポートできます。

1. 設定 → 外観 を開きます。
2. テーマ設定 エリアを探します。
3. テーマをエクスポート ボタンをクリックします。
4. 保存先を選択します。設定は JSON 形式で保存されます。

エクスポートされる内容は次のとおりです。

• テーマモード（ライト / ダーク / システム）
• アクセントカラー設定
• フォントの上書き設定
• 壁紙設定（ぼかし、マスク不透明度、その他のパラメーター）
• カスタム CSS コード

備考

壁紙画像ファイル自体はエクスポートに含まれず、壁紙設定パラメーターのみが含まれます。ローカルの壁紙画像を使用している場合は、インポート後に壁紙パスを再設定する必要があります。

テーマをインポートする

1. 設定 → 外観 → テーマ設定 を開きます。
2. テーマをインポート ボタンをクリックします。
3. テーマ JSON ファイルを選択します。
4. システムがインポートによるテーマ差分をプレビュー表示します。確認して適用します。

診断情報のエクスポート

診断情報は、トラブルシューティング時にテクニカルサポートへ提供するためのものです。インポートはサポートされていません。

1. 設定 → システム を開きます。
2. 診断情報をエクスポート ボタンをクリックします。
3. システムが実行時情報、ログ、設定などを収集し、診断ファイルを生成します。
4. 単一の JSON ファイルまたは完全な ZIP アーカイブとしてエクスポートできます。

詳細は 診断ツール を参照してください。

注意事項

• API Key のセキュリティ: どのエクスポート機能でも、API Keys などの機密認証情報はエクスポートされません。インポート後に手動で再入力する必要があります。
• バージョン互換性: エクスポートされたデータファイルにはバージョン情報が含まれます。新しいバージョンでエクスポートされたファイルは、古いバージョンではインポートできない場合があります。
• ファイルサイズ: 多数の添付ファイル参照を含むチャットをエクスポートすると、大きなファイルが生成される場合があります。添付ファイル自体はエクスポートに含まれません。
• 文字エンコーディング: すべてのエクスポートファイルは、クロスプラットフォーム互換性のために UTF-8 エンコーディングを使用します。

---

インポート / エクスポート中に問題が発生した場合は、よくある問題 を参照してください。