MCP Integration with Rillet

The Rillet Model Context Protocol (MCP) server allows AI tools such as Claude Desktop and AI-powered development environments to interact directly with your Rillet data.

By configuring the MCP server, you can connect supported AI tools to your Rillet environment and run queries or retrieve information using your Rillet API.

The Rillet MCP server is hosted at:

https://docs.api.rillet.com/mcp

Once configured, AI assistants can query your Rillet environment using your API credentials.

Before You Begin

Before configuring the MCP connection, make sure the following requirements are met:

• You have access to your Rillet organization.

• You have generated a Rillet API key.

• Claude Desktop is installed.

• Node.js is installed on your system.

If you need instructions for generating an API key, see API Access.

Install Claude Desktop

To use the MCP server with Claude, you must first install Claude Desktop.

1. Download Claude Desktop from https://claude.ai.

2. Open the downloaded installer.

3. Follow the on-screen installation instructions.

4. Open Claude Desktop and sign in with your Claude account.

Install Node.js

The MCP connector requires Node.js to run the MCP client.

Windows

1. Go to https://nodejs.org.

2. Download the LTS Windows Installer (.msi).

3. Run the installer and follow the installation steps.

4. Ensure Add to PATH is enabled.

5. Restart any open terminals.

To verify the installation, open Command Prompt and run:

node -v
npx -v

macOS

Locate the Claude Configuration Folder

To configure the MCP connector, you must edit the Claude Desktop configuration file.

1. Open Claude Desktop.

2. Select your profile name in the bottom-left corner.

3. Select Settings.

4. Select Developer.

5. Select Edit Config.

Claude opens the configuration folder containing the file:

claude_desktop_config.json

If the file does not exist, create a new file with this exact name.

If the Configuration Folder Does Not Open

If Edit Config does not open the Claude configuration folder, you can locate it manually.

Windows

1. Press Windows + R.

2. In the Run window, enter:

%APPDATA%

1. Press Enter.

2. Open the Claude folder. If the folder does not exist, create a new folder named Claude.

macOS

Add the Rillet MCP Configuration

To connect Claude Desktop to the Rillet MCP server, you must add the MCP configuration to the Claude configuration file.

Follow these steps:

1. Open the file:

claude_desktop_config.json

1. Paste the following configuration into the file.

2. Replace YOUR_API_KEY_HERE with your Rillet API key.

Windows

{
  "mcpServers": {
    "rillet-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.api.rillet.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

macOS

1. Save the file after updating the configuration

Restart Claude Desktop

After updating the configuration file, restart the application.

1. Close Claude Desktop completely.

2. Reopen the application.

Restarting the application reloads the MCP configuration.

Enable the Rillet MCP Connector

After restarting Claude Desktop:

1. Open Claude Desktop.

2. Select your profile icon.

3. Go to Connectors.

4. Locate Rillet MCP.

5. Select Configure.

Once configured, Claude can connect to your Rillet environment through the MCP server.

Test the MCP Connection

To verify that the MCP connection works correctly:

1. Open Claude Desktop.

2. Start a new chat.

Example query:

How many customers do I have?

If the configuration is correct, Claude will retrieve information from your Rillet environment using the MCP server.

(Optional) Create a Claude Project for API Authentication

Some users may experience authentication issues unless the API key is included in each chat.

Creating a Claude Project allows you to store the API key so it is reused automatically.

To create a project:

1. Open the Projects section in Claude Desktop.

2. Select Create Project.

3. Enter a project name.

4. Add your API key to the project instructions.

5. Start chats from the project to automatically include the authentication information.

API Documentation

For more advanced MCP configuration and integration guidance, refer to the Rillet API documentation.

Available documentation includes:

• API Reference: Provides detailed information about available API endpoints.

• Guides (Getting Started): Includes integration examples and implementation guides.

• API Changelog: Lists updates and changes to the API.

See Also

Review the following articles for related configuration and access management topics.

• API Access

• Create and Manage Custom Roles

• Manage Members

• Single Sign-On (SSO) and Authentication Options