Connect your assistant

Ask your own Orijin supply-chain data questions in plain language, from the AI assistant your team already uses - no new dashboard, no exports, no SQL.

Access is read-only and scoped to your organisation only.

What you need from Orijin

Your Orijin contact will send you two things:

A server URL - e.g. https://mcp.orijin.io/mcp/<your-org>
An API key - a long secret string, e.g. orijin_live_xxxxxxxxxxxxxxxxxxxx

Claude Code (CLI)

One command - replace the URL and key with the ones Orijin gave you:

claude mcp add --transport http orijin https://mcp.orijin.io/mcp/<your-org> --header "Authorization: Bearer <YOUR_API_KEY>"

Start Claude Code and type /mcp to confirm it shows orijin - connected.

List or check: claude mcp list
Remove: claude mcp remove orijin

Claude Desktop

Claude Desktop connects to remote servers through a helper called mcp-remote. It requires Node.js.

Add this to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "orijin": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.orijin.io/mcp/<your-org>",
        "--header", "Authorization: Bearer <YOUR_API_KEY>"
      ]
    }
  }
}

Save, then restart Claude Desktop. The Orijin tools appear in the tools menu.

Try it

“How many of our farms are active?”
“Show plot mapping coverage by region.”
“List certifications that are expired.”
“How many procurement lots are still pending payment?”
“What’s the risk-score breakdown across our farms?”

The assistant picks the right tool automatically and answers from your live data. Ask it to show the underlying numbers if you want to verify.

Good to know

Read-only. Nothing you or the assistant does can change or delete data.
Your data only. The key is tied to your organisation; it cannot see any other client’s data.
Rate limit. Up to 100 requests per minute per key. Heavy back-and-forth may briefly pause - just retry.
Your data stays in Orijin. Only the answers to your questions leave, and only to the assistant you connected.

Troubleshooting

Symptom	Likely cause / fix
“Connected” but tools error with 401/403	Key is wrong, expired, or the URL org doesn’t match the key. Re-check both; contact Orijin for a fresh key.
Tools time out	The server URL is wrong, or a network/firewall block. Confirm the exact URL with Orijin.
Claude Desktop shows nothing	Node.js not installed, or a typo in the config JSON. Validate the JSON and restart Desktop.
Web (claude.ai) can’t add it	The browser client requires OAuth, which isn’t available yet - use Claude Code or Claude Desktop.

Questions, or a new key: contact your Orijin representative.

What agents can do