Add an MCP Server
MCP servers are added to a Hub. Navigate to MCP Servers in the sidebar and click Add Server.
Understanding MCP server types
Before adding a server, it helps to know which type you are dealing with.
stdio servers
These run as a local process on the MCP Proxy. Bloque supports servers launched by:
npx— Node.js-based servers published to npmpipx— Python-based servers published to PyPI
Servers that require docker (Docker-in-Docker) or a separate local installation are not supported.
Remote servers
These are already running somewhere on the internet and expose an HTTP or SSE endpoint.
| Scenario | Supported? |
|---|---|
| Server supports OAuth Dynamic Client Registration (e.g., Notion, Tally) — Bloque can register its own client automatically | ✅ Yes — add by URL |
| Server supports OAuth DCR but requires your client to be pre-approved (e.g., ClickUp) | ❌ No |
| Server requires you to register your own OAuth client ID and secret (e.g., Slack, GitHub) | ✅ Yes — add via the registry, which has pre-configured templates |
Methods
Smart wizard (recommended)
Click Add Server and use the smart wizard. It accepts:
- A GitHub repository URL
- An npm package name
- A JSON config snippet (for example, copied from a Claude Desktop
mcpServersblock)
Bloque fetches the metadata, detects the transport type and default command, and pre-fills the form. Review and save.
Search the registry
Type a name or keyword in the search bar to find one of Bloque's official server templates and add it in one click. The template pre-fills the transport type and default arguments.
Manual entry
Fill in the form directly:
| Transport | Required fields |
|---|---|
stdio | Command (npx or pipx), arguments (one per line) |
HTTP | Server URL |
SSE (deprecated) | Server URL |
For stdio servers you can also set environment variables that are injected into the process at startup. Sensitive values are encrypted and never shown in plain text after saving.
Limits per Hub
| Plan | MCP servers per Hub |
|---|---|
| Free | 10 |
| Starter | 20 |
| Pro | 30 |
After adding
Once added, a server appears in your MCP Servers list. If it requires authentication (OAuth or API key), see Authenticate. To customise its behavior, see Configure.
Adding a server via a "Run on Bloque" button
Some server authors add a Run on Bloque button to their README so you can add their server with a prefilled preview instead of entering it manually. See Run on Bloque Button.