Connect AI
Bring your AI to NPerseus.
Choose your AI, copy its connection details, and approve sign-in. Then use NPerseus from your chats.
Choose your AI client
Claude Code
Add the ResearchOS MCP server at https://nperseus.com/mcp (transport http) and install the plugin researchos from the marketplace Ayushkiller/researchos-plugins, then run its authentication.
- Open Claude Code and paste the prompt above.
- It registers the MCP server, installs the plugin from the researchos-plugins marketplace, and prompts you to authenticate.
What happens next: A browser tab opens the first time a ResearchOS tool is used — sign in with your lab Google account, approve access, done.
Tokens are visible and revocable any time at /workspace/connect-ai.
Claude Desktop
https://nperseus.com/mcp
- Settings → Connectors → Add custom connector.
- Paste the URL above, then click Connect.
What happens next: A browser tab opens — sign in with your lab Google account. Done.
Tokens are visible and revocable any time at /workspace/connect-ai.
Claude.ai
https://nperseus.com/mcp
- Settings → Connectors → Add custom connector (same flow as Claude Desktop, in your browser).
- Paste the URL above, then click Connect.
What happens next: A browser tab (or the same tab) prompts you to sign in with your lab Google account. Done.
Tokens are visible and revocable any time at /workspace/connect-ai.
ChatGPT
https://nperseus.com/mcp
- Open ChatGPT setup below, choose Create app (+), and enter NPerseus as the name.
- Paste the copied URL, keep OAuth selected, and create the connection.
- Sign in with NPerseus and approve the access shown.
What happens next: Review the discovered tools. Start a new chat, add this connection from the tools menu, and ask it to browse public lab projects or your assigned workspace projects.
Setup help
If Create app is missing, check Settings → Security and login → Developer mode. Availability depends on your account and workspace policy. Advanced OAuth settings should automatically use Dynamic Client Registration (DCR), read + write scopes, and no base scopes.
Tokens are visible and revocable any time at /workspace/connect-ai.
Codex
codex mcp add researchos --url https://nperseus.com/mcp codex mcp login researchos
- Run both lines above in the terminal where you use the Codex CLI.
- The first line registers the server; the second starts sign-in.
What happens next: codex mcp login opens a browser tab — sign in with your lab Google account. Done.
Tokens are visible and revocable any time at /workspace/connect-ai.
Cursor
https://nperseus.com/mcp
- Settings → MCP → Add server.
- Paste the URL above, then sign in when prompted.
What happens next: A browser tab opens — sign in with your lab Google account. Done.
Tokens are visible and revocable any time at /workspace/connect-ai.
Start with the lab’s research
Every connected member can read public projects, profiles, publications, patents, news, opportunities and resources. Private workspace records follow your account permissions.
Try: “Show all Ayush Kumar’s public projects and the full details of ContextGuard.”
Your assigned workspace projects are a separate list. An empty list there does not limit access to public research.
Access, tokens and other connection methods
OAuth connections request read and write access within your existing lab role. Review proposed changes in your AI; destructive tools also require a separate confirmation. Admin access requires an explicitly verified client.
Use the MCP setup above for ChatGPT. Custom GPT Actions use a separate REST/OpenAPI integration. Clients without OAuth can use a personal access token from Connect an AI in your workspace.
Having trouble connecting?
- Complete any human verification in your browser before continuing with Google.
- Use your registered lab account. Public research does not require a linked member profile or a project assignment; private workspace access follows your account permissions.
- If an older connection reports invalid_scope, start authorization again. Normal setup requests read and write access; admin access requires a separately verified client.
- Opening the MCP URL as a webpage can show “Method not allowed”. Paste it into the AI connection settings instead.
Admins: see the integration guide for wiring a Custom GPT Action to OAuth.