Using with Claude Code

Claude Code deploys to Telbase with the Telbase skills. The Telbase MCP server is optional: it gives Claude tools to look at and manage your apps without a shell.

Setup

npm install -g telbase
telbase login

telbase skill install

Deploy this app to Telbase

How Claude deploys

Following the skills, Claude:

• reads the project: framework, how it builds and starts, its database, the env vars it reads;
• registers the app with telbase apps create <name> --provider vercel|cloudrun, with --database postgres|sqlite when it needs one;
• creates the schema and loads the app's data with telbase db run <app> -- <command>;
• sets the app's env vars on the provider;
• deploys with telbase vercel or telbase gcloud: the Vercel CLI and gcloud, run through Telbase with your Telbase session;
• checks the app at its Telbase URL, reads the logs with telbase logs --project <app> when something fails, fixes and redeploys;
• reports the URL, what runs where, and every change it made to your code.

When Telbase refuses something (a plan limit, a provider feature it does not offer), the answer names the reason and what to run instead, and the skills tell Claude to follow it rather than retry.

You can also ask Claude naturally:

Deploy this to Telbase
Deploy this app with a PostgreSQL database
Require sign-in for my team at acme.com on this app

The MCP server

Register it once:

telbase mcp register

This runs claude mcp add --scope user telbase, which Claude Code keeps in~/.claude.json; restart Claude Code to pick it up. Without the claude command, it prints the line to run instead. The server has 45 tools. It has no deploy tool: Claude deploys with the provider CLIs, as the skills say.

• Session and apps: get_session, register_app, list_apps, get_app, protect_app
• Deploys and logs: list_deploys, get_deploy_status, get_deploy_logs, cancel_deploy, get_app_logs, rollback_deploy, list_rollback_targets
• Projects: list_projects, get_project, update_project, delete_project
• Running app: check_app_health, restart_service, reset_service, suspend_service, resume_service
• Env vars: set_env_vars, list_env_vars, delete_env_var
• Database: get_database_info, enable_database_extension
• Custom domains: add_custom_domain, verify_custom_domain, list_custom_domains, remove_custom_domain
• Scheduled jobs: get_job_executions, run_scheduled_job, pause_job, resume_job, update_schedule
• File storage: get_storage_info, get_storage_credentials
• GitHub: get_github_status, connect_github, toggle_auto_deploy
• Team and organization: list_team, invite_member, list_orgs, switch_org
• Account: get_account_status

telbase mcp unregister removes it.

Prompt Examples

Deploy a new app

Build me a project tracker with a PostgreSQL database using Next.js and Prisma, then deploy it to Telbase.

Deploy an existing project

Deploy this project to Telbase.

Add a database to an existing app

Add a SQLite database to this app using Prisma, create a schema for tracking approvals, then redeploy to Telbase.

Set environment variables and redeploy

Set these environment variables on my Telbase app and redeploy:
- OPENAI_API_KEY=sk-...
- RESEND_API_KEY=re_...

Debug a failed deploy

My last deploy to Telbase failed. Read the build log and the app's logs, fix it, and redeploy.

Add a custom domain

Set up app.acme.com as a custom domain on my Telbase app and tell me the DNS record to add.

Deploy a Docker container

Deploy this Java Spring Boot app to Telbase using the existing Dockerfile.

Add a scheduled job

Run this data pipeline as a Telbase scheduled job every hour at the top of the hour, Eastern time.

Next Steps

• Quick Start — deploy your first app
• Databases — PostgreSQL, SQLite, migrations, and pgvector
• CLI Reference — every command
• Guides & Articles — tips and patterns for deploying with Claude Code