MCP Getting Started
AROYA MCP Setup Guide — Claude and ChatGPT
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.
Part 1 — 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?"
Part 2 — 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
Connected, but the assistant can't see any facilities? Two things have to be true before data flows: your role at the facility must have MCP permission, and MCP access must be enabled for the facility. The assistant will tell you which one is missing.
Problem 1 — "Your facility role does not have permission to use MCP." MCP is enabled for the facility, but your user role hasn't been granted MCP permission. Ask your AROYA facility administrator to grant it. This can also appear after access was previously working, if roles or permissions were changed.
Problem 2 — "0 facilities available / MCP access has not been enabled for that facility yet." The connection is working, but the facility hasn't been switched on for MCP. Reach out to AROYA support to request access.
After access is granted. No reconnect is needed. Ask again (for example, "what facilities do I have access to?") and the assistant will re-check and confirm the facility it can now see.
Other problems. 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).