RationalBloks MCP Server
Deploy production APIs in minutes. Tools for projects, schemas, deployments, modules, object storage, and graph data — delivered on infrastructure you own (self-host or your own BYOC cluster).
接入你的智能体
發布者自己的 URL。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
https://mcp.rationalbloks.com/上方的 Claude 按鈕會開啟 Claude,並填好名稱和 URL。你仍需在那裡確認。
claude mcp add --transport http com.rationalbloks-mcp https://mcp.rationalbloks.com/Run in a terminal.
{ "mcpServers": { "com.rationalbloks-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.rationalbloks.com/" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
RationalBloks MCP lets AI agents (Claude Code, Claude Desktop, Cursor, VS Code, etc.) deploy production APIs from a JSON schema, and deploy and run the frontends and backends built on them. No backend code to write. No infrastructure to manage.
"Create a task management API with tasks, projects, and users"
→ 2 minutes later: Production API running on Kubernetes
# recommended — no install step; @latest checks for a new release at every start
uvx rationalbloks-mcp@latest
# or install into an environment
pip install rationalbloks-mcp
Visit rationalbloks.com/settings and create an API key. A key carries scopes: a read key reaches only the read tools, a read + write key reaches every tool. The server lists only the tools your key may call.
Claude Code — remote server (no install):
claude mcp add --transport http rationalbloks https://mcp.rationalbloks.com/mcp \
--header "Authorization: Bearer rb_sk_your_key_here"
or the local server:
claude mcp add --env RATIONALBLOKS_API_KEY=rb_sk_your_key_here rationalbloks \
-- uvx rationalbloks-mcp@latest
--scope project writes the server to the repository's .mcp.json instead, to share it with a team. Keep the key out of the file with "Authorization": "Bearer ${RATIONALBLOKS_API_KEY}": Claude Code expands the variable from each developer's environment.
VS Code — add to .vscode/mcp.json (Cursor: .cursor/mcp.json with a mcpServers key):
{
"servers": {
"rationalbloks": {
"command": "uvx",
"args": ["rationalbloks-mcp@latest"],
"env": {
"RATIONALBLOKS_API_KEY": "rb_sk_your_key_here"
}
}
}
}
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"rationalbloks": {
"command": "uvx",
"args": ["rationalbloks-mcp@latest"],
"env": {
"RATIONALBLOKS_API_KEY": "rb_sk_your_key_here"
}
}
}
}
Any other client: point it at https://mcp.rationalbloks.com/mcp (Streamable HTTP) with Authorization: Bearer rb_sk_....
Every tool that can lose data carries destructiveHint: true, and no other tool can lose data. One allow rule covers the server, and ask rules keep a prompt on the tools that can lose data. Claude Code evaluates ask rules before allow rules, so they prompt even though the server is allowed, and in auto mode they still prompt, because they run before the classifier. Add this to .claude/settings.json (the project) or ~/.claude/settings.json (every project):
{
"permissions": {
"allow": ["mcp__rationalbloks"],
"ask": [
"mcp__rationalbloks__update_schema",
"mcp__rationalbloks__drop_schema_items",
"mcp__rationalbloks__deploy_destructive",
"mcp__rationalbloks__rollback_project",
"mcp__rationalbloks__delete_project",
"mcp__rationalbloks__update_graph_schema",
"mcp__rationalbloks__rollback_graph_project",
"mcp__rationalbloks__delete_graph_project",
"mcp__rationalbloks__delete_graph_node",
"mcp__rationalbloks__delete_graph_relationship",
"mcp__rationalbloks__set_module_env",
"mcp__rationalbloks__delete_module"
]
}
}
Add "mcp__rationalbloks__deploy_production" to ask to approve each production release yourself.
Asked before every change: allow only the read tools instead. These rules match every read tool and no other:
{
"permissions": {
"allow": [
"mcp__rationalbloks__get_*",
"mcp__rationalbloks__list_*",
"mcp__rationalbloks__search_graph_nodes",
"mcp__rationalbloks__fulltext_search_graph",
"mcp__rationalbloks__traverse_graph",
"mcp__rationalbloks__preview_schema_change"
]
}
}
Read-only server: register a second server with a read key. It lists only the read tools and the platform refuses every other call, so one rule allows all of it:
claude mcp add --transport http rationalbloks-read https://mcp.rationalbloks.com/mcp \
--header "Authorization: Bearer rb_sk_your_read_key"
{ "permissions": { "allow": ["mcp__rationalbloks-read"] } }
Auto mode reads autoMode only from ~/.claude/settings.json, managed settings or --settings, never from a project's .claude/settings.json. If its classifier blocks routine RationalBloks calls, describe your project there, keeping $defaults (replace MyProject and apps.yourdomain.com with your project's name and your cluster's domain):
{
"autoMode": {
"environment": [
"$defaults",
"Key internal services: RationalBloks (MCP server rationalbloks, https://mcp.rationalbloks.com), where our project MyProject runs; its staging environment is for development",
"Trusted internal domains: rationalbloks.com and *.rationalbloks.com; *.apps.yourdomain.com, where MyProject's APIs and modules are served",
"Sensitive remote targets: MyProject's production environment"
]
}
}
Run claude auto-mode config to see the rules in effect, or edit them in /permissions (Auto mode tab).
Read tools only read. Write tools change something, and never lose data. Destructive tools can lose data, and carry destructiveHint: true: they replace a whole schema (update_schema, update_graph_schema), drop, delete, roll back, deploy a plan that drops data (deploy_destructive), or overwrite a module's environment (set_module_env).
A plan drops data when it drops a table or field, or changes a field's type in a way that rounds or cuts its stored values (a decimal given a smaller scale or turned integer, a datetime turned date). The deploy tools refuse such a plan and name each drop; deploy_destructive applies it.
A long operation (create, deploy, rollback, delete, module operations) runs as a job: the tool answers a job_id, and get_job_status follows it to its result.
A module is one of a project's own frontends (frontblok) or backends (logicblok), built from a GitHub repository and run beside the project.
Schemas must be in FLAT format:
{
"tasks": {
"title": {"type": "string", "max_length": 200, "required": true},
"status": {"type": "string", "max_length": 50, "enum": ["pending", "done"]},
"due_date": {"type": "date", "required": false}
},
"projects": {
"name": {"type": "string", "max_length": 100, "required": true}
}
}
These are automatic - don't define them:
id (UUID primary key)created_at (datetime)updated_at (datetime)row_version (integer: the row's version, 1 on insert and one more on every update)Use the built-in app_users table:
{
"employee_profiles": {
"user_id": {"type": "uuid", "foreign_key": "app_users.id", "required": true},
"department": {"type": "string", "max_length": 100}
}
}
get_schema_reference covers the advanced features: row policies, computed fields, unique groups (nulls_not_distinct for groups with nullable columns, deferrable for groups checked at commit), audit trails, the generated API's scoped deletes, and writes that state the row_version they read (If-Match, if_version).
For frontend development, use our NPM packages:
npm install @rationalbloks/frontblok-auth @rationalbloks/frontblok-crud
These provide:
getApi().getAll(), getApi().create(), etc.Proprietary - Copyright 2026 RationalBloks. All Rights Reserved.
Deploy production REST and Neo4j Graph APIs from JSON schemas in seconds.
{ "mcpServers": { "com.rationalbloks-mcp": { "url": "https://mcp.rationalbloks.com/", "headers": {} } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 http 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:RATIONALBLOKS_API_KEY。
RationalBloks 透過 HTTP 存取。
上次檢查時間:2026-11-16。 Deploy production REST and Neo4j Graph APIs from JSON schemas in seconds.