> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# トラブルシューティング

> アプリやCLIがホストに接続できない、サインインの期限が切れた、MCPサーバが失敗する、プラグインがオフになっている、通知が届かない、といったときの対処法。

まずはここから始めます。

```bash theme={null}
archetype --doctor          # config, model, keys and records, without calling a model
archetype daemon status     # whether the background service runs, for each folder
archetype --version
```

## アプリがホストに接続できない

デスクトップアプリは、自身のホストを動かします。準備が整ったあとでホストが停止した場合、アプリは5分間に3回までホストを再起動します。起動中に停止した場合は、アプリが理由を表示し、**Try Again**と**Show Log**を示します。

* 手動で再起動するには、**ファイル → Archetypeを再起動**を使います。
* アプリに\*\*ホストが再起動しました。Archetypeをもう一度開くと再接続します。\*\*と表示された場合は、アプリを閉じて開き直します。
* **サーバ上のホスト：**アプリはシステムの`ssh`で接続します。ターミナルから、パスワードの入力なしで使える必要があります。**再接続**（**ファイル**、または**管理 → 設定 → サーバ**）を使います。古いバージョンのサーバには、**アップデートして再接続**が表示されます。それでも接続できない場合は、**このコンピュータを使う**で、代わりにローカルのホストを開きます。
* **スマートフォン：**コンピュータに**接続できません**と表示された場合は、コンピュータの電源が入っていて、そこでアプリかそのホストが動いているかを確認します。ポートが使用中だとArchetypeに表示された場合は、設定ファイルの`phones.port`に別のポートを指定します。[デバイス](https://docs.archetype.ing/ja/use/devices.md)を参照してください。

## チャット、スケジュール、トリガーが応答しない

これらはバックグラウンドサービスで、アプリを閉じていても実行されます。

```bash theme={null}
archetype daemon status                # exits 0 only while it runs
archetype daemon logs -n 100 --follow  # its log
archetype daemon restart               # start it again with the config as it is now
archetype daemon install               # install it again if it is missing
```

アプリに\*\*バックグラウンドサービスはインストール済みですが実行されていないため、チャットに応答しません。\*\*と表示された場合は、**再起動**を押します。

サービスは、シェルの環境を引き継ぎません。キーとトークンは`~/.config/archetype/env`に、1行に1つずつ`NAME=value`の形で書き、あなただけが読めるようにします（`chmod 600`）。ほかの人が読める状態だと、サービスは起動しません。

## サインインの期限が切れた

| 場所 | 表示 | 対処 |
| - | - | - |
| モデルやエンジン | **サインインの有効期限が切れました。もう一度サインインしてください。** | 表示された場所で、もう一度サインインします。[エンジン](https://docs.archetype.ing/ja/use/engines.md)を参照してください。 |
| チーム | **開くには…にサインインしてください** | サイドバーから会社にサインインします。 |
| アプリ（Gmail、Notion、Linearなど） | **再接続が必要** | **管理 → 接続 → アプリ**で、もう一度接続します。 |
| メッセンジャーのアカウント | **再接続** | そのアカウントで押します。[アカウント](https://docs.archetype.ing/ja/use/accounts.md)を参照してください。 |

## MCPサーバが失敗する

```bash theme={null}
archetype mcp list          # the servers, and the plugins' own
archetype mcp check NAME    # start it and list its tools
archetype mcp login NAME    # sign in, for a server that asks
```

あるターンで接続できないサーバは、そのターンから除かれ、残りはそのまま動きます。`"disabled": true`のサーバは実行されません。[MCPサーバ](https://docs.archetype.ing/ja/extend/mcp.md)を参照してください。

## プラグインがオフになっている、または見当たらない

* **管理 → プラグイン**を確認します。**下書き**と**食事**は、オンにするまでオフです。
* `~/.config/archetype/config.json`でオフにしたプラグイン（`"plugins": { "name": false }`）は、オフのままです。
* 会社のホストでは、どのロールがプラグインを見られ、ツールを使えるかを管理者が選びます。あなたのロールにない場合は、管理者に頼んでください。[会社をホストする](https://docs.archetype.ing/ja/teams/hosting.md)を参照してください。
* **ミュージック**はMacでのみ動作し、ArchetypeによるアプリのコントロールをmacOSで許可する必要があります。[ミュージック](https://docs.archetype.ing/ja/plugins/music.md)を参照してください。

## 通知が届かない

* **管理 → 自分の設定 → 通知の設定**を開きます。デバイスごとに、通知を受け取るかどうかが表示されます。**システム設定でオフ**、**このブラウザでオフ**、**このブラウザがブロック**、**届きません**が、届かない理由を示します。
* システムの設定でArchetypeの通知をオンにしてから、もう一度確認します。
* **おやすみ時間**の間はお知らせが保留され、**通知をオフにしたセッション**には何も届きません。
* 会話がフォーカスのあるウィンドウに表示されている間は、その会話のお知らせは表示されません。
* チームのメンション、返信、決定は、そのチーム自身の設定に従います。

## ログの場所

| 内容 | 場所 |
| - | - |
| デスクトップアプリのホスト | **ヘルプ → ログを表示**、または**ヘルプ → ログフォルダを表示** |
| バックグラウンドサービス | `archetype daemon logs`、またはフォルダの記録の中の`daemon/daemon.log` |
| 自分で運用する会社のホスト | `docker compose logs -f archetype` |

ログにアクセストークンは含まれません。ログを送る前に、個人的な情報が含まれていないか確認してください。

## 問題を報告する

[help@archetype.ing](mailto:help@archetype.ing)に、次の内容をメールで送ってください。

* 何をしたか、何を期待したか、何が起きたか
* コンピュータとシステム、そして`archetype --version`の出力
* `archetype --doctor`の出力と、問題の前後のログの行
* 接続したアプリやプラグインの場合は、その名前


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.