Connecting the PlantPredict MCP Connector

The PlantPredict MCP connector lets you work with PlantPredict directly from your AI assistant, in plain language. Once connected, you can ask it to create and run predictions, import weather and shade scenes, browse your projects, and read results — and it acts entirely as you, using your own PlantPredict account and permissions. Your AI assistant talks to a secure PlantPredict connector, which in turn calls the PlantPredict API on your behalf. You connect once, sign in with your PlantPredict account, and you are ready to go. This guide covers three AI tools: Claude, ChatGPT, and Cursor. Follow the section for the tool you use. The sections at the end — What you can do with it, Good to know, If something goes wrong, and Need help? — apply to all three.

Before you begin

Claude
ChatGPT
Cursor

Use a Claude plan that supports custom connectors — Pro, Max, Team, or Enterprise. (The Free plan cannot add custom connectors.)
Make sure your PlantPredict company has connector access. An administrator must enable “Allow MCP Server Access For API Users,” and your company must have an active, qualifying subscription. Without both, Claude will connect but every action returns an “MCP access is not enabled” message.
Have your PlantPredict email and password ready — you sign in once during setup.
Use this connector address when Claude asks for it: https://mcp.plantpredict.terabase.energy

Use a ChatGPT plan that supports custom connectors. Custom (MCP) connectors are available on paid plans; on Business and Enterprise workspaces an administrator may need to add or approve the connector first, and on some plans you enable connector or developer settings before the option appears. If you do not see it, check with your ChatGPT workspace administrator.
Make sure your PlantPredict company has connector access. An administrator must enable “Allow MCP Server Access For API Users,” and your company must have an active, qualifying subscription. Without both, ChatGPT will connect but every action returns an “MCP access is not enabled” message.
Have your PlantPredict email and password ready — you sign in once during setup.
Use this connector address when ChatGPT asks for it: https://mcp.plantpredict.terabase.energy

Use a recent version of Cursor. You can add PlantPredict with a one-click link, or by pasting one short entry into Cursor’s MCP configuration — both take under a minute and are shown below. On Business or Enterprise Cursor plans, an administrator may control which MCP servers are allowed, so check with them if the server is blocked.
Make sure your PlantPredict company has connector access. An administrator must enable “Allow MCP Server Access For API Users,” and your company must have an active, qualifying subscription. Without both, Cursor will connect but every action returns an “MCP access is not enabled” message.
Have your PlantPredict email and password ready — you sign in once during setup.
Use this connector address when Cursor asks for it: https://mcp.plantpredict.terabase.energy

Claude

Part 1: Connect Claude on the web

Menu names may vary slightly depending on your Claude plan and version, but the flow is the same.

Open claude.ai in your browser and sign in to your account.

Open your connector settings

Go to Customize, then open the Connectors section.

Claude Settings with the Connectors section open

Add a custom connector

Click Add custom connector to start adding PlantPredict.

The Add custom connector option in Claude's connector settings

Enter the connector details

Give it a name you will recognize, such as PlantPredict, and paste the connector address into the remote MCP server URL field: https://mcp.plantpredict.terabase.energy. Then click Add.

The Add custom connector dialog with the name and connector address filled in

Claude opens a PlantPredict sign-in window. Enter your PlantPredict email and password and approve access. Your password goes only to PlantPredict — Claude never sees or stores it.

The PlantPredict sign-in window opened during connector setup

Confirm it is connected

Once you approve, the connector shows as Connected and the PlantPredict tools become available to Claude.

The PlantPredict connector listed as Connected

Part 2: Connect the Claude desktop app

The desktop app uses the same steps as the web version:

Open the Claude desktop app and go to Settings, then Connectors.
Click Add custom connector.
Enter a name and the same connector address (https://mcp.plantpredict.terabase.energy), then sign in with your PlantPredict account.

Check that it is working

Start a new conversation, make sure the PlantPredict connector is turned on for it, and try a prompt such as:

“List my PlantPredict projects.”
“Create a new project in Berkeley, CA.”
“Create a 5 MW prediction in project <project-id>/<project-name> and run it.”
“Show the summary results for prediction <prediction-id>/<prediction-name>.”

Claude will use the PlantPredict tools to answer, and you will see the results right in the conversation.

A new Claude conversation using a PlantPredict tool and returning results

ChatGPT

Connect ChatGPT to PlantPredict

Menu names may vary slightly depending on your ChatGPT plan and version, but the flow is the same.

Open chatgpt.com in your browser and sign in to your account.

Open your connector settings

Go to Settings, then open the Plugins section. Depending on your plan, connectors may live under a Beta features or Advanced area that you turn on first.

Add a custom connector

Choose to add or create a custom connector to start adding PlantPredict by clicking the + button.

Enter the connector details

Give it a name you will recognize, such as PlantPredict, and paste the connector address into the MCP server URL field: https://mcp.plantpredict.terabase.energy. If you are asked how to authenticate, choose OAuth. Then create the connector.

The custom connector form with the name and MCP server URL filled in

ChatGPT opens a PlantPredict sign-in window. Enter your PlantPredict email and password and approve access. Your password goes only to PlantPredict — ChatGPT never sees or stores it.

Turn it on and confirm

Once you approve, PlantPredict appears in your list of connectors, and its tools become available to ChatGPT.

The PlantPredict connector connected and enabled in ChatGPT

Check that it is working

Start a new chat, turn on the PlantPredict connector for that chat (from the Plugins or tools menu), and try a prompt such as:

“List my PlantPredict projects.”
“Create a new project in Berkeley, CA.”
“Create a 5 MW prediction in project <project-id>/<project-name> and run it.”
“Show the summary results for prediction <prediction-id>/<prediction-name>.”

ChatGPT will use the PlantPredict tools to answer, and you will see the results right in the chat.

A new ChatGPT chat using a PlantPredict tool and returning results

Cursor

Add the PlantPredict server

In Cursor, the New MCP Server button opens a configuration file (mcp.json) rather than a fill-in form. The quickest way to avoid touching that file is the one-click link in Option A; if you prefer to do it by hand, Option B shows the one entry to paste. Use either — you only need one.

Option A: One-click link
Option B: Add it by hand

Use the “Add to Cursor” link below to let Cursor add PlantPredict for you — no files to edit. Click the link, then click through the prompts.

cursor://anysphere.cursor-deeplink/mcp/install?name=PlantPredict&config=eyJ1cmwiOiAiaHR0cHM6Ly9tY3AucGxhbnRwcmVkaWN0LnRlcmFiYXNlLmVuZXJneSJ9

Open the link

Click the “Add to Cursor” link above, or paste it into your browser’s address bar.

Allow it to open Cursor

If your browser asks whether to open Cursor, choose to open it.

Install

In Cursor, click Install to add the PlantPredict server.

Connect

Click Connect to start signing in to PlantPredict.

Enter your credentials and click Sign In.

Finished

Cursor shows a successful connection.

Cursor showing a successful connection after sign in

Open Cursor Settings, go to Tools & MCPs, and click Add Custom MCP. Cursor opens the mcp.json file. Add the PlantPredict entry inside the mcpServers section, then save:

{
  "mcpServers": {
    "PlantPredict": {
      "url": "https://mcp.plantpredict.terabase.energy"
    }
  }
}

If the file already has other servers, add PlantPredict as another item inside mcpServers. Cursor picks up the change as soon as you save.

The file Cursor opens from Settings is ~/.cursor/mcp.json, which makes PlantPredict available in every project.

The PlantPredict entry added to mcp.json

Finish connecting

However you added it, PlantPredict requires you to sign in, so Cursor shows the server as needing authentication. Click Connect. Cursor opens a PlantPredict sign-in window — enter your PlantPredict email and password and approve access. Your password goes only to PlantPredict; Cursor never sees or stores it.

The Cursor connection waiting to connect

Finish signing in

Enter your credentials and click Sign In.

Turn it on and confirm

Once you approve, the server shows as connected (a green indicator) and the PlantPredict tools appear in its list. Make sure the PlantPredict server’s toggle is on.

The PlantPredict server connected and enabled in Cursor, with its tools listed

Check that it is working

Open Cursor’s Agent (the chat in Agent mode), make sure PlantPredict is enabled, and try a prompt such as:

“List my PlantPredict projects.”
“Create a new project in Berkeley, CA.”
“Create a 5 MW prediction in project <project-id>/<project-name> and run it.”
“Show the summary results for prediction <prediction-id>/<prediction-name>.”

Cursor’s Agent will call the PlantPredict tools to answer — you may be asked to approve each tool run — and you will see the results right in the chat.

Cursor's Agent using a PlantPredict tool and returning results

What you can do with it

These sections apply to Claude, ChatGPT, and Cursor alike. Once connected, you can ask your AI assistant to help with tasks such as:

Browse your projects and predictions, and read their results.
Create, size, and run predictions.
Import weather files and 3D shade scenes.
Generate and download reports.
Look up modules, inverters, and other library items.

Good to know

It acts as you. Everything your AI assistant does runs under your PlantPredict account and permissions — nothing you could not do yourself.
Your password is never stored. Only short-lived access tokens are used after you sign in.
You may need to sign in again occasionally. If prompted, simply reconnect — this is expected.
Access is limited by region. Connections from US-sanctioned countries are intentionally blocked.
Claude — new tools appear in a new conversation. If you just connected and do not see PlantPredict tools, start a fresh conversation.
ChatGPT — turn the connector on in each chat. In a new chat, enable PlantPredict from the connectors or tools menu so ChatGPT can use it.
Cursor — use Agent mode. PlantPredict tools are available to Cursor’s Agent; a plain chat without the Agent will not call them.
Cursor — you may be asked to approve tool runs. Cursor can prompt before running a tool — approve to continue, or turn on auto-run in settings if you prefer.

If something goes wrong

Most issues have a quick fix:

"MCP access is not enabled for your organization."

Your company does not yet have connector access. Ask a PlantPredict administrator to enable “Allow MCP Server Access For API Users” and confirm your subscription is active.

"Authentication failed" or an invalid/expired token

In Claude or ChatGPT, disconnect and reconnect the PlantPredict connector — it will sign you in again and refresh automatically. In Cursor, open Tools & Integrations settings and click Login again (or turn the PlantPredict server off and back on).

You do not see the PlantPredict tools

Start a new conversation or chat with the connector turned on. In Cursor, make sure the PlantPredict server is turned on in settings and that you are using the Agent.

ChatGPT — you do not see the option to add a custom connector

Your plan or workspace may not have custom connectors enabled — check with your ChatGPT workspace administrator.

Cursor — the one-click link does not prompt anything

Use Option B instead — click New MCP Server and paste the entry into mcp.json.

Cursor — the server shows a red dot, "no tools," or will not connect

Check that the URL in mcp.json is exactly the connector address above, and that you completed the Login step for a green, connected status.

Access is blocked (error 403)

The connection is coming from a region where access is not permitted.

Need help?

If you cannot connect or an action keeps failing, contact your PlantPredict administrator or PlantPredict support, and let us know what you were doing and the exact message you saw. We will look into it.

​Before you begin

​Claude

​Part 1: Connect Claude on the web

​Part 2: Connect the Claude desktop app

​Check that it is working

​ChatGPT

​Connect ChatGPT to PlantPredict

​Check that it is working

​Cursor

​Add the PlantPredict server

​Finish connecting

​Check that it is working

​What you can do with it

​Good to know

​If something goes wrong

​Need help?

Before you begin

Claude

Part 1: Connect Claude on the web

Part 2: Connect the Claude desktop app

Check that it is working

ChatGPT

Connect ChatGPT to PlantPredict

Check that it is working

Cursor

Add the PlantPredict server

Finish connecting

Check that it is working

What you can do with it

Good to know

If something goes wrong

Need help?