Connect your assistant

Ontyx works inside the AI assistant you already use. You add it as a connector, sign in with your Ontyx account in a browser window, and your assistant can then work with your organization’s data. There’s nothing to install and no key to paste.

The server address is:

https://mcp.ontyx.io/mcp

https://mcp.ontyx.io and https://mcp.ontyx.io/mcp reach the same server, so either works.

The dashboard’s Organization page shows the exact address for your account, with a copy button.

Before you start

You need an Ontyx account that belongs to an organization. Accounts are by invitation: an owner or admin of your company’s organization invites you from the dashboard’s Members page, and the link in the email signs you up. If you already have an account, you join the next time you sign in. Someone who signs in without belonging to an organization is told by their assistant to ask the person who runs Ontyx for their company for an invite.

Your account must have accepted the current Terms of Service. New accounts accept while signing up. If you signed up before the current terms, sign in at /legal/accept and accept once. Until then your assistant shows a message saying the terms need accepting, with that link. Accept, then ask again: you don’t need to reconnect.

What your assistant can do

What the connector offers depends on your role in the organization:

Owners and admins get every tool: setting up datasets, loading data, approving changes, saving metrics and views, and asking questions.
Readers see only the tools that read: listing datasets, metrics and views, asking questions, and looking up where data came from. Their assistant never offers to load or approve anything, and if it tries anyway, Ontyx refuses before doing anything.

A role change takes effect on your next request, and so does being removed from the organization. If a new role adds tools, your assistant may need to reconnect before it lists them.

Claude

Add the connector from claude.ai in a browser, not from the iOS or Android app. The mobile apps can use a connector once it exists, but they have no screen for adding a custom one. A mobile browser works fine.

Go to claude.ai and open Settings → Connectors.
Click Add custom connector.
Paste the server address:
```
https://mcp.ontyx.io/mcp
```
Click Add. A browser window opens for Ontyx sign-in.
Sign in and approve access.

The connector then syncs to your Claude account, so it’s available in the mobile apps and Claude Desktop too. Try: “What datasets do we keep in Ontyx?”

ChatGPT

Requires a paid plan (Plus, Pro, Business, Enterprise or Edu) and developer mode.

Open Settings → Security and login and turn on Developer mode. On Business, Enterprise and Edu, a workspace admin must allow it first under Workspace Settings → Permissions & Roles.
Go to your apps and connectors settings and create a new developer-mode app.
Enter https://mcp.ontyx.io/mcp, including the /mcp path.
Create the connection and complete the Ontyx sign-in when prompted.
Review the tools it found and turn on the ones you want.

New connectors appear under Drafts until you turn them on.

Grok

Requires a paid Grok plan.

Go to grok.com/connectors.
Click New Connector, then choose Custom.
Enter https://mcp.ontyx.io/mcp.
Complete the Ontyx sign-in when prompted.

Gemini

Support depends on which Gemini you use:

Gemini Enterprise: an administrator registers Ontyx as a custom MCP server (Streamable HTTP with OAuth 2.0) for your company.
Gemini CLI: can reach remote MCP servers, though its sign-in support has been uneven; you may need the mcp-remote bridge.
The consumer Gemini app: you can’t add a custom connector there today. Use one of the assistants above.

Other assistants and tools

Ontyx is a standard remote MCP server with OAuth sign-in (Streamable HTTP), so it works with any client that supports those. Known to work: VS Code with GitHub Copilot, Cursor, Zed, Amazon Q Developer CLI and the Docker MCP Toolkit. Point them at https://mcp.ontyx.io/mcp and follow their instructions for remote servers.

A client that can reach a remote server but can’t sign in through a browser can use a personal API key instead. See Authentication.

Managing access

Disconnect by removing the connector in your assistant’s settings. Your data stays in Ontyx.
Remove someone from the organization on the dashboard’s Members page. Their assistant loses access on its next request.
Calls about your own data are never metered. The market context tools carry their own note on usage.

When a connection drops

Ontyx updates can end an open connection. Most assistants reconnect on their own. If yours says the Ontyx tools are unavailable, or shows the connector as connected with no tools, disconnect the connector and connect it again (in Claude: Settings → Connectors), then try your question again. A new conversation picks up the fresh connection.

Troubleshooting

The assistant says the Terms of Service haven’t been accepted, or have changed. Your account hasn’t accepted the current terms. Go to /legal/accept, sign in, accept, then ask again. No reconnection needed.

“This person isn’t in an organization in Ontyx yet.” You’re signed in, but nobody has added you to an organization. Ask the person who runs Ontyx for your company to invite you from the Members page, then accept the invite.

“Only an owner or admin of your organization can do that.” You’re a reader, and the request would change something. Ask an owner or admin, or ask them to change your role.

“Couldn’t register with Ontyx’s sign-in service.” Check that you’re adding the connector from the claude.ai website rather than the mobile app. If it still fails, wait a minute and press Connect again.

Connected, but the assistant says it has no Ontyx tools. Remove and re-add the connector with https://mcp.ontyx.io/mcp. If it persists, check that your client supports remote MCP servers over Streamable HTTP, not only local ones.

No “Add custom connector” option anywhere. You’re probably in the mobile app. Custom connectors can only be added from the website.

Sign-in opens but never completes. Check that pop-ups aren’t blocked, and that you’re signing in to the account you expect. If you have several, the approval screen shows which one.

Next steps

Quickstart: set up a dataset, load it, and ask your first question.
Tools reference: every tool your assistant can call.

Introduction Quickstart