Connect to HyperAI MCP
Register the HyperAI MCP server in Claude Code or Cursor, sign in with your HyperAI account, and verify the connection.
This guide walks through connecting the HyperAI MCP server (https://mcp.hyper.ai) from Claude Code and Cursor.
Prerequisites
- A HyperAI account. The OAuth flow signs you in through the HyperAI account portal in your browser.
- One of the supported MCP clients installed: Claude Code or Cursor.
Note
HyperAI's authorization service does not support Dynamic Client Registration yet, so the setup below passes a pre-registered OAuth client ID explicitly. Clients that only support Dynamic Client Registration (for example Codex CLI and ChatGPT connectors) cannot complete the sign-in flow at the moment.
Claude Code
Register the server with the claude mcp add command:
claude mcp add --transport http \
--client-id fpmu80lf8syq0omg7xpww --callback-port 8080 \
hyperai https://mcp.hyper.aiBy default this registers the server for the current project only. Add --scope user to make it available in every project on your machine.
Then start claude and run /mcp (or run claude mcp login hyperai from the shell) to complete the browser sign-in and consent screen. Once the status shows connected, the HyperAI tools are available in your session.
To remove the server later:
claude mcp remove hyperaiCallback port
The OAuth callback is fixed at http://localhost:8080/callback. If port 8080 is occupied by another process during sign-in, free it first — the port is part of the registered OAuth application and cannot be changed on the client side.
Cursor
Cursor is configured through a JSON file: ~/.cursor/mcp.json (machine-wide) or .cursor/mcp.json in a project. Add the server with a static OAuth client:
{
"mcpServers": {
"hyperai": {
"url": "https://mcp.hyper.ai",
"auth": {
"CLIENT_ID": "fpmu80lf8syq0omg7xpww",
"scopes": ["mcp:access"]
}
}
}
}Open Cursor's MCP settings, and when prompted, complete the browser sign-in. Cursor's OAuth callback is fixed at http://localhost:8787/callback.
Verify the connection
Ask your AI assistant to call the user_get_profile tool, for example:
Who am I on HyperAI?
A successful call returns your HyperAI username, display name, email, membership status, balance, and organizations. If it does, the connection is working.
Enable only some tool groups
To keep the tool list small, register the server with a features query parameter listing only the groups you need (user, compute, resources, dataset):
claude mcp add --transport http \
--client-id fpmu80lf8syq0omg7xpww --callback-port 8080 \
hyperai "https://mcp.hyper.ai/?features=compute,dataset"The same URL works in Cursor's mcp.json.
Troubleshooting
Authorization fails or is denied
If the browser sign-in completes but the client reports an authorization error, your account may not have MCP access enabled. Contact HyperAI support to have it enabled for your account.
- The browser window never opens — run the login command again (
/mcpin Claude Code, or re-open the server entry in Cursor's MCP settings), and check that no firewall is blocking the local callback port. - Tools disappear after a while — the access token has expired; re-run the login flow to refresh the session.