Help
| Symptom | Fix | Section |
|---|---|---|
| Cannot add SolarSENS, sign-in fails, or the prompt returns | Check the address. Reconnect. | Cannot connect |
| Cloudflare says the email is not allowed | Ask AVA Asia to allow it. | Email not allowed |
| SolarSENS asks you to link the account, or "Invalid nonce" | Link once. | Link the account |
| Old or missing tools | Refresh the tools. | Refresh tools |
| A Plant is missing | Check the account. | Plant missing |
| Empty or incomplete answer | Narrow the question. | Incomplete answer |
| "Failed to attach prompt" | Use YYYY-MM-DD. | Prompt error |
| Cloudflare Error 1010 | Set a User-Agent. | Error 1010 |
| OpenCode port 19876 error | Use a free port. | OpenCode port |
Cannot connect
- Ask your workspace administrator to allow the plugin or custom connection.
- Use
https://ops.solarsens.co/mcpand the email that AVA Asia allowed. See Sign in. - 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
- Open Settings in ChatGPT.
- Under Integrations, select Plugins.
- Open SolarSENS.
- Scroll to Manage app.
- On the Refresh tools row, select Refresh tools.
- 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.
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_portto a free port, for example19877, in thesolarsensentry ofopencode.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.
