@renderbase/mcp-server

Renderbase MCP server for Claude Desktop - manage templates and generate documents through natural conversation.

Installation

Option 1: One-Click Install (Recommended)

Coming Soon: Install directly from the Claude Desktop Extensions directory.

Or install from the .mcpb bundle:

1. Download renderbase-mcp-{version}.mcpb from the releases page
2. In Claude Desktop, go to Settings → Extensions
3. Click Install from file and select the downloaded .mcpb file
4. Enter your Personal Access Token when prompted
5. Done! Start chatting with Claude about your documents.

Option 2: NPX (Manual Setup)

Install globally:

npm install -g @renderbase/mcp-server

Or use directly with npx (recommended):

npx @renderbase/mcp-server

Manual Setup

1. Get a Personal Access Token (PAT)

1. Log in to your Renderbase Dashboard
2. Go to Settings → Personal Access Tokens
3. Click Create Token
4. Enter a label (e.g., "Claude Desktop")
5. Select expiry (max 30 days)
6. Copy the token - it won't be shown again!

2. Configure Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "renderbase": {
      "command": "npx",
      "args": ["-y", "@renderbase/mcp-server"],
      "env": {
        "RENDERBASE_USER_TOKEN": "pat_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. Restart Claude Desktop

Close and reopen Claude Desktop. You should see "renderbase" in your available MCP servers.

Available Tools

Workspace Tools

| Tool | Description | |------|-------------| | list_workspaces | List all workspaces you have access to | | get_workspace | Get details of a specific workspace |

Template Tools

| Tool | Description | |------|-------------| | list_templates | List templates in a workspace | | get_template | Get template details and schema | | create_draft_template | Create a new draft template | | update_draft_template | Update a draft template | | validate_schema | Validate template schema | | get_schema_reference | Get template schema documentation |

Data Tools

| Tool | Description | |------|-------------| | parse_data_file | Parse Excel or CSV data to JSON | | map_variables | Auto-map data columns to template variables |

Generation Tools

| Tool | Description | |------|-------------| | preview_template | Generate a preview document | | generate_document | Generate a production document | | get_job_status | Check document generation status |

Example Usage

Once configured, you can have natural conversations with Claude:

You: Create an invoice template with company logo, client details, and line items table.

Claude: I'll create that for you. Let me check your workspaces first...

[Creates template using Renderbase tools]

You: Generate an invoice for Acme Corp with 3 line items totaling $1,500.

Claude: I'll generate that invoice now...

[Generates PDF using your template]

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RENDERBASE_USER_TOKEN | Yes | Your Personal Access Token (starts with pat_) | | RENDERBASE_API_URL | No | Custom API URL (default: https://api.renderbase.dev/api) |

Security

• Token Expiry: PATs expire after max 30 days
• Draft-Only: Templates created via MCP are drafts until manually published
• Audit Logging: All operations are logged in your team's activity feed
• Revocable: Instantly revoke tokens from your dashboard

Troubleshooting

"Invalid token" error

• Verify your token starts with pat_
• Check if the token has expired
• Generate a new token from your dashboard

"Failed to connect" error

• Check your internet connection
• Verify the Renderbase API is accessible
• Try regenerating your PAT

Claude Desktop not finding the server

• Check your config file JSON syntax
• Ensure npx is in your PATH
• Restart Claude Desktop completely

Documentation

• Full Integration Guide
• Template Schema Reference
• API Documentation

Support

• Email: [email protected]
• Issues: GitHub Issues

Building from Source

Build the MCPB Bundle

To build the Claude Desktop extension bundle:

cd integrations/mcp-server
npm install
npm run build:mcpb

This creates:

• dist-mcpb/renderbase-mcp-{version}.mcpb - The extension bundle
• dist-mcpb/renderbase-mcp-{version}.mcpb.sha256 - Checksum file

Bundle Contents

renderbase-mcp-{version}.mcpb
├── manifest.json     # Extension metadata and configuration
├── server/           # Compiled server code
│   ├── index.js
│   └── client.js
└── icon.png          # Extension icon (optional)

Directory Submission

To submit to the Claude Desktop Extensions directory:

1. Build the MCPB bundle: npm run build:mcpb
2. Test locally by installing via "Install from file"
3. Submit via Anthropic's Extension Submission Form
4. Include:
   • Extension name and description
   • Privacy policy URL
   • Terms of service URL
   • 3+ usage examples
   • Safety annotations (data access, network access)

License

MIT