AROYA MCP Setup Guide for Claude and ChatGPT
Overview
Connect your AROYA account to an AI assistant so you can ask questions about your facilities, rooms, and zones in plain language. Both setups use the same server:
Server URL: https://mcp.aroya.io/mcp
Authentication: OAuth (sign in with your normal AROYA email and password)
The connection is read-only and limited to what your AROYA account can already see.
BEFORE YOU START: FACILITY ACCESS MUST BE ENABLED
Connecting the server does not by itself grant data access. If the assistant replies that you have a facility membership but "MCP access has not been enabled for that facility yet," an AROYA administrator needs to enable it.
Give the assistant the facility name and it will return a prefilled AROYA support link to request access.
Connect AROYA to Claude
Custom connectors are available on Claude Pro, Max, Team, and Enterprise plans, in the web app and desktop app.
Step 1: Open Connectors
In Claude, go to Settings → Connectors and click Add custom connector.
Step 2: Enter the server details
Name: AROYA. Remote MCP server URL: https://mcp.aroya.io/mcp. Leave the advanced OAuth fields blank, then click Add.
Step 3: Sign in to AROYA
Click Connect next to the new AROYA connector. A new tab opens: at Please login to continue, enter your AROYA email and password, then click Authorize on the Connect Claude screen. Close the feedback popup if one appears. The connector now shows as connected.
Step 4: Turn AROYA on in a chat
Start a new chat, open the tools menu (the + / search-and-tools button next to the message box), and make sure AROYA is toggled on.
Step 5: Ask a question
For example: "What AROYA facilities do I have access to?"
Connect AROYA to ChatGPT
Custom MCP servers are available on ChatGPT Plus and above.
Step 1: Open Plugins and add a custom MCP server
In ChatGPT's left sidebar click Plugins. In the top-right corner click Add ▾ and choose Add custom MCP server.
Step 2: Fill in the server details
Name: AROYA. Description: optional. Connection: https://mcp.aroya.io/mcp (Server URL tab). Authentication: OAuth. Leave Advanced OAuth settings alone.
Step 3: Accept the risk notice and create
Tick I understand and want to continue, then click Create as a plugin.
Step 4: Sign in to AROYA and authorize ChatGPT
On the Connect AROYA dialog click Continue to AROYA. A new tab opens: at Please login to continue, enter your AROYA email and password, then click Authorize on the Connect ChatGPT screen. Close the feedback popup if one appears. You'll return to ChatGPT with a "Primary is now connected" banner, and AROYA appears under Installed with your account as Primary.
Step 5: Use it in a chat
Click Try in chat, or start a new chat and type @AROYA followed by your question, e.g. "@AROYA What AROYA facilities do I have access to?"
What you can ask once connected
The assistant can read your facility and zone data, including sensor readings (VWC, temperature, RH, VPD, EC, PPFD), irrigation and drainage diagnostics, device health and alerts, cultivation and crop records, and CSV or Parquet exports on request.
Example prompts
"What facilities can I see in AROYA?"
"What was the average VWC by zone in Flower 2 over the last week?"
"Give me an irrigation diagnosis for Flower 2 over the past three days."
"Export last month's pore EC for Flower 2 as a CSV."
Tip: name the facility, room, and time window in your question for faster, more precise answers.
Troubleshooting
If something breaks or data is missing, say so in the chat. The assistant can file feedback directly with the AROYA team.
To disconnect, remove the connector in Claude (Settings → Connectors) or the plugin in ChatGPT (Plugins → AROYA → Manage).
Check out our MCP FAQs for more answers on access, exports, and what the connection can and can't do.
