Claude MCP Server

The RayDB Claude MCP (Model Context Protocol) Server enables seamless integration with Claude AI, allowing you to interact with your RayDB database directly through Claude. This integration leverages the Model Context Protocol to provide Claude with access to your database resources.

Installation

To install the RayDB MCP server in Claude, use the following command:

claude mcp add --transport http raydb https://mcp.raydb.io/mcp

This command configures Claude to communicate with the RayDB MCP server via HTTP, enabling you to query and manage your database through Claude's interface.

Authentication Scopes

The RayDB MCP server supports three authentication scopes that control what operations users can perform:

Read-only

Users with read-only access can only view items in your database. This scope is ideal for:

• Analyzing data and generating reports
• Inspecting database structure and contents
• Creating analytical queries without modification risk

Write

Users with write access can create and update items but cannot delete them. This scope is suitable for:

• Creating new database records
• Updating existing items
• Building and maintaining data without risk of accidental deletion

Admin

Users with admin access have full control and can create, update, and delete items. This scope should be reserved for:

• Database administrators
• Full database management and maintenance
• Operations that require complete control

Usage

Once installed, you can interact with your RayDB database through Claude using natural language queries. Claude will use the MCP server to execute your requests according to your assigned authentication scope.

Security Best Practices

• Assign appropriate scopes: Grant users the minimum access level they need for their tasks
• Review permissions regularly: Regularly audit who has access to your database and at what scope level
• Use read-only for analysis: When possible, use read-only scopes for analytical and reporting tasks
• Protect admin credentials: Restrict admin scope access to trusted users only

Troubleshooting

If you encounter issues with the MCP server connection:

1. Verify the installation: Confirm the MCP server is properly configured in Claude
2. Check authentication: Ensure your authentication credentials and scope are correctly set up
3. Network connectivity: Verify that your system can reach https://mcp.raydb.io/mcp
4. Scope limitations: If an operation is denied, verify that your current scope allows that action