A step-by-step guide to connecting Claude, ChatGPT, or Cursor to PlantPredict via the MCP connector
This feature is available on all PlantPredict subscriptions.
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. Select the tab for the tool you use below. 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.
Menu names may vary slightly depending on your Claude plan and version, but the flow is the same.
1
Sign in to Claude
Open claude.ai in your browser and sign in to your account.
2
Open your connector settings
Go to Customize, then open the Connectors section. Alternatively, you can access your connector settings from the Settings menu.
Claude Settings, with the Connectors section open.
3
Add a custom connector
Click Add custom connector to start adding PlantPredict.
The Add custom connector option in Claude's connector settings.
4
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.
5
Sign in with your PlantPredict account
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 that Claude opens during setup.
6
Confirm it is connected
Once you approve, the connector shows as Connected and the PlantPredict tools become available to Claude.
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.
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
Menu names may vary slightly depending on your ChatGPT plan and version, but the flow is the same.
1
Sign in to ChatGPT
Open chatgpt.com in your browser and sign in to your account.
2
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.
The Plugins section in ChatGPT settings.
3
Add a custom connector
Choose to add or create a custom connector to start adding PlantPredict by clicking the + button.
The option to add a custom connector in ChatGPT.
4
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.
5
Sign in with your PlantPredict account
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.
The PlantPredict sign-in window that ChatGPT opens during setup.
6
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.
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.
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
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.
Click the “Add to Cursor” link above, or paste it into your browser’s address bar.
2
Allow it to open Cursor
If your browser asks whether to open Cursor, choose to open it.
3
Install
In Cursor, click Install to add the PlantPredict server.
Cursor's install prompt after opening the "Add to Cursor" link.
4
Connect
Click Connect to start signing in to PlantPredict.
Cursor's connect prompt after clicking Install.
5
Sign in
Enter your credentials and click Sign In.
The PlantPredict sign-in window that Cursor opens during setup.
6
Finished
Cursor shows a successful connection.
Cursor has 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:
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.
2
Finish signing in
Enter your credentials and click Sign In.
The PlantPredict sign-in window that Cursor opens during setup.
3
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.
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.
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.
"MCP access is not enabled for your organization."
Your company does not yet have connector access. Contact PlantPredict support and we will get it turned on for you.
"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.
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.
⌘I
Assistant
Responses are generated using AI and may contain mistakes.
