Claude Code MCP setup: add vbtnl as a remote MCP server

Claude Code connects to vbtnl as a remote MCP server over HTTP. You need a vbtnl account and Claude Code installed.

Option 1: sign in (recommended)

Run in your terminal:

claude mcp add --transport http vbtnl https://api.vbtnl.com/mcp

Start Claude Code, type /mcp, choose vbtnl and then Authenticate. A vbtnl page opens in your browser: log in and press Allow.

Option 2: personal token

Create a personal token in your vbtnl account. Its value is shown once, so copy it right away. Then run:

claude mcp add --transport http vbtnl https://api.vbtnl.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Replace YOUR_TOKEN with the token (it starts with vbtnl_pat_) and restart Claude Code.

Check the connection

In Claude Code type /mcp. The vbtnl server should be listed as connected. Then ask:

List my vbtnl projects.

Deploy your first app

Make a Telegram bot that answers /start with a greeting. Host it on vbtnl.

Claude Code writes the files into the project on vbtnl, runs it and gives you a draft address. Say "ship it" to publish to production.

Make it available in every folder

By default claude mcp add saves the server for the current folder only. Add --scope user to use vbtnl from any folder:

claude mcp add --scope user --transport http vbtnl https://api.vbtnl.com/mcp

Troubleshooting

• The server shows as failed or needs authentication. Run /mcp and authenticate again. With a token, check that the header reads Authorization: Bearer followed by the full token.
• The agent edits local files instead of the project on vbtnl. Say it directly: "build this on vbtnl". On vbtnl the code lives on the server, not in your folder.
• Remove the server: claude mcp remove vbtnl.