Skip to content

Connect an MCP client

The emely MCP server is a remote MCP server at:

https://mcp.emely.io/mcp

It 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.

  1. Open Settings, then Connectors.
  2. Choose Add custom connector.
  3. Enter https://mcp.emely.io/mcp as the connector URL and confirm.
  4. Sign in at app.emely.io when the browser opens, then approve the consent screen.
  5. The emely tools appear in the tools menu of a chat. Ask “which emely workspaces am I in?” to check the connection.
  1. Add the server:

    Terminal window
    claude mcp add --transport http emely https://mcp.emely.io/mcp

    The default local scope loads it in the current project only. Pass --scope user to load it in all your projects, or --scope project to share it with the team through a committed .mcp.json.

  2. In a Claude Code session, run /mcp, select the emely server and choose Authenticate.

  3. Sign in at app.emely.io when the browser opens, then approve the consent screen. The server asks for the openid graphql:role:user scope.

  4. 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.

  1. Enable developer mode in Settings.
  2. Add a custom connector with the URL https://mcp.emely.io/mcp.
  3. Sign in at app.emely.io when the browser opens, then approve the consent screen.
  1. Add the server and start the OAuth login:

    Terminal window
    codex mcp add emely --url https://mcp.emely.io/mcp
    codex mcp login emely
  2. Sign in at app.emely.io when the browser opens, then approve the consent screen. The server asks for the openid graphql:role:user scope.

  3. In the codex TUI, /mcp lists 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.