# Help

| Symptom                                                    | Fix                           | Section                                  |
| ---------------------------------------------------------- | ----------------------------- | ---------------------------------------- |
| Cannot add SolarSENS, sign-in fails, or the prompt returns | Check the address. Reconnect. | [Cannot connect](#cannot-connect)        |
| Cloudflare says the email is not allowed                   | Ask AVA Asia to allow it.     | [Email not allowed](#email-not-allowed)  |
| SolarSENS asks you to link the account, or "Invalid nonce" | Link once.                    | [Link the account](#first-time-link)     |
| Old or missing tools                                       | Refresh the tools.            | [Refresh tools](#chatgpt-refresh-tools)  |
| A Plant is missing                                         | Check the account.            | [Plant missing](#plant-missing)          |
| Empty or incomplete answer                                 | Narrow the question.          | [Incomplete answer](#incomplete-answer)  |
| "Failed to attach prompt"                                  | Use `YYYY-MM-DD`.             | [Prompt error](#failed-to-attach-prompt) |
| Cloudflare Error 1010                                      | Set a `User-Agent`.           | [Error 1010](#error-1010)                |
| OpenCode port 19876 error                                  | Use a free port.              | [OpenCode port](#opencode-port)          |

## Cannot connect

1. Ask your workspace administrator to allow the plugin or custom connection.
2. Use `https://ops.solarsens.co/mcp` and the email that AVA Asia allowed. See [Sign in](https://ai.solarsens.co/docs/installation/sign-in.md).
3. Reconnect in the connection settings of your AI app. A client can ask you to sign in again after a server change. Your access did not change.

## Email not allowed

The verified email does not match the SolarSENS access policy. Retry with the intended email. If it still fails, ask AVA Asia to allow that exact address.

## Link the account

This is the first connection for your Cloudflare identity.

* Own account: open the link page. Sign in once with that account.
* Shared account: do not enter the shared password. Ask AVA Asia to approve the mapping.

Reconnect the client after the link is active. For "Invalid nonce", the one-time form expired or was used. Reconnect and open the new link page.

## Old or missing tools

Some AI apps keep a copy of the tool list. A new sign-in does not update it.

### ChatGPT: Refresh tools

1. Open **Settings** in ChatGPT.
2. Under **Integrations**, select **Plugins**.
3. Open SolarSENS.
4. Scroll to **Manage app**.
5. On the **Refresh tools** row, select **Refresh tools**.
6. Start a new chat and select SolarSENS.

If **Refresh tools** is not available, ask the person who manages the plugin. In other apps, refresh the tool list in the connection settings.

### Tool names changed on 2026-10-12

If the assistant calls `query_device_timeseries`, `get_string_analytics`, `get_device_catalog`, or `get_performance`, refresh the tools. The new tools are `query_string_5min`, `query_inverter_daily`, `get_string_daily_analytics`, `list_devices`, and `get_plant_daily_performance`.

## Plant missing

Ask the assistant to list your Plants. Check that you signed in with the intended account. If the Plant is still absent, ask AVA Asia to check your Plant access.

## Incomplete answer

* Name one Plant, an exact date, and the value you need.
* Ask if the result had no records, missing measurements, or an error.
* For a large request, start with one day or one inverter.
* For alarms, ask if the assistant read every page.
* Ask what the assistant could not check.

## Failed to attach prompt

The `plant-performance-review` prompt accepts only `YYYY-MM-DD`, for example `2026-10-09`.

## Cloudflare Error 1010

Cloudflare blocks some default HTTP client signatures, for example the Python `urllib` `User-Agent`. Set a descriptive `User-Agent` header, or use an MCP client.

[![Cloudflare Error 1010 page](/assets/images/error-1010-2372653a2161f9ac5b1ad34a58f2bef7.png)](https://ai.solarsens.co/assets/images/error-1010-2372653a2161f9ac5b1ad34a58f2bef7.png)

## OpenCode port

`opencode mcp auth solarsens` can fail with "Failed to start server. Is port 19876 in use?" Do one of these:

* Set `oauth.callback_port` to a free port, for example `19877`, in the `solarsens` entry of `opencode.json`.
* Stop `opencode serve --service`. Run the command. Restart the service.

## Contact AVA Asia

Send an email to <support@solarsens.co>. Give the app name, the server address, the time, and the error message. Add the Plant name and date range if your process allows it.
