Server URL
Usehttps://app.ruby.ad/mcp as the Ruby MCP server URL.
Add this URL in any compatible MCP client that supports remote MCP servers with OAuth authentication. Client-specific setup steps vary by product and are not covered in this page.
What it enables
Once connected, the Ruby MCP Server lets your MCP client work with Ruby on behalf of the authenticated user. The first version exposes tools to:- identify the current Ruby user and workspace;
- list available agents;
- list conversations, create conversations, create messages, and retrieve conversation messages;
- retrieve Pod information and Pod tasks;
- list, read, create, search, and resolve files scoped to conversations or Pods;
- search across workspace Spaces.
Authentication and permissions
The Ruby MCP Server uses OAuth. In most compatible clients, authentication starts automatically after you add the MCP Server URL. You will be asked to sign in to Ruby and select the workspace to connect. The connected client acts as the authenticated Ruby user. It can only access the Ruby data, Spaces, conversations, Pods, and files that this user can access in Ruby. Tokens issued for the MCP Server are scoped to MCP usage and are not Ruby API keys. Note: API keys are not used to connect to the Ruby MCP Server. Use the OAuth flow initiated by your MCP client.OAuth client registration
Ruby supports the OAuth client registration mechanisms used by MCP clients:- Dynamic Client Registration (DCR), for clients that register dynamically with the authorization server during setup.
- Client ID Metadata Documents (CIMD), for clients that identify themselves through a client metadata document.
Required resource parameter
MCP clients must include the OAuth resource parameter in both authorization and token requests. This parameter identifies the MCP Server the token is intended for and allows Ruby to issue tokens scoped to the Ruby MCP Server.
Clients that omit the resource parameter are not supported. If your client fails during OAuth, check whether it follows the MCP authorization specification for resource parameters: Model Context Protocol authorization specification.
Admin controls
Workspace admins can disable Ruby MCP Server access for their workspace. Admins can also control which redirect URIs are allowed during client authentication. If a user cannot connect, check that the Ruby MCP Server is enabled for the workspace and that the MCP clientβs redirect URI is allowed.Compatibility
The Ruby MCP Server is designed for clients that support remote MCP servers and the latest MCP authorization flow, including OAuth resource parameters. Some MCP clients may not work if they do not implement the expected OAuth metadata discovery or required authorization parameters. If authentication fails before the Ruby login screen, update the client and confirm that it supports remote MCP servers with OAuth, including theresource parameter.
Troubleshooting
If the connection does not work:- Confirm that you are using the correct region URL, either
https://app.ruby.ad/mcporhttps://app.ruby.ad/mcp. - Confirm that your MCP client supports remote MCP servers with OAuth authentication.
- Confirm that your MCP client includes the OAuth
resourceparameter in authorization and token requests. - Ask a Ruby workspace admin to confirm that Ruby MCP Server access is enabled for the workspace.
- If the client shows a redirect URI or OAuth error, ask an admin to verify that the redirect URI is allowed.
Related pages
- Adding an MCP Server, for adding external MCP servers as tools inside Ruby.
- Client-side MCP Server, for developers exposing local client-side tools to Ruby conversations.
- Access Controls and Permissions, for how Ruby workspace roles and Spaces control access.
- Model Context Protocol authorization specification, for the OAuth requirements implemented by MCP clients and servers.