Connect an MCP client
The emely MCP server is a remote MCP server at:
https://mcp.emely.io/mcpIt uses OAuth 2.1. When you connect, your browser opens the emely app. You sign in with your normal emely sign-in and consent at app.emely.io. You need no separate account or key.
The connection acts as you. It sees and does exactly what you see and do in the emely app, never more, with your own rights in each workspace. If you are emely staff, a connection made this way is a normal user connection: staff rights never reach it.
The server asks for the openid graphql:role:user scope. When your sign-in runs out, your client refreshes it, or asks you to reconnect. See Authentication.
Staff who use the society and catalogue-import tools connect with the api_operator scope instead; see Authentication.
Claude (web and desktop)
Section titled “Claude (web and desktop)”- Open Settings, then Connectors.
- Choose Add custom connector.
- Enter
https://mcp.emely.io/mcpas the connector URL and confirm. - Sign in at
app.emely.iowhen the browser opens, then approve the consent screen. - The emely tools appear in the tools menu of a chat. Ask “which emely workspaces am I in?” to check the connection.
Claude Code
Section titled “Claude Code”-
Add the server:
Terminal window claude mcp add --transport http emely https://mcp.emely.io/mcpThe default
localscope loads it in the current project only. Pass--scope userto load it in all your projects, or--scope projectto share it with the team through a committed.mcp.json. -
In a Claude Code session, run
/mcp, select the emely server and choose Authenticate. -
Sign in at
app.emely.iowhen the browser opens, then approve the consent screen. The server asks for theopenid graphql:role:userscope. -
The emely tools appear under the server in
/mcp.
Remove it with claude mcp remove emely. Removing a remote server also deletes the OAuth tokens and client registration Claude Code stored for it.
ChatGPT
Section titled “ChatGPT”- Enable developer mode in Settings.
- Add a custom connector with the URL
https://mcp.emely.io/mcp. - Sign in at
app.emely.iowhen the browser opens, then approve the consent screen.
-
Add the server and start the OAuth login:
Terminal window codex mcp add emely --url https://mcp.emely.io/mcpcodex mcp login emely -
Sign in at
app.emely.iowhen the browser opens, then approve the consent screen. The server asks for theopenid graphql:role:userscope. -
In the
codexTUI,/mcplists the active servers.
The equivalent ~/.codex/config.toml entry is:
[mcp_servers.emely]url = "https://mcp.emely.io/mcp"Remove it with codex mcp remove emely.