MCP server
The TeamOnly MCP server
Let your AI tool deploy the app it built, behind your company login, then read the live logs and fix what breaks. One line of setup in Claude Code, Cursor, VS Code, Claude Desktop or Windsurf.
claude mcp add teamonly -- npx -y teamonly mcpclaudeDeploy this app on TeamOnly01What it does
Deploy from the chat
The MCP server gives your AI tool the TeamOnly actions as tools it can call: set up the project, deploy, check who can open the app, read its logs, store a secret, sign you in.
So you can stay in the conversation. Say “deploy this app on TeamOnly” and the agent does it. If the app shows an error, it can watch the live logs, find the problem, fix the code and deploy again on its own.
The rules files that npx teamonly init adds (the Claude Code skill, AGENTS.md and the Cursor rule) are still the main way your AI learns the stack. The MCP server is for tools that prefer tools over terminal commands, like Claude Desktop or Cursor’s agent without a terminal. The CLI keeps working exactly as before.
02Install
Add it to your AI tool
Every tool starts the same command on your computer: npx -y teamonly mcp. You need Node.js 20 or newer.
Claude Code
Run this once in your terminal:
claude mcp add teamonly -- npx -y teamonly mcpCursor
Click the button to install it in Cursor, or add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project):
{
"mcpServers": {
"teamonly": {
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}VS Code
Run this once in your terminal:
code --add-mcp '{"name":"teamonly","command":"npx","args":["-y","teamonly","mcp"]}'Or add this to .vscode/mcp.json in your project. VS Code uses servers and "type": "stdio":
{
"servers": {
"teamonly": {
"type": "stdio",
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}Claude Desktop
Open Settings, then Developer, then Edit Config, and add this to claude_desktop_config.json. Restart Claude Desktop afterwards.
{
"mcpServers": {
"teamonly": {
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}Windsurf
Add this to Windsurf’s MCP config file, mcp_config.json:
{
"mcpServers": {
"teamonly": {
"command": "npx",
"args": ["-y", "teamonly", "mcp"]
}
}
}Other tools
Any MCP client that runs local servers can use it. The command is npx with the arguments -y teamonly mcp, over stdio. It is also in the official MCP Registry as dev.teamonly/teamonly.
npx -y teamonly mcp03Tools
What your AI can do with it
Twelve tools. Your AI tool shows each call and, in most tools, asks you before it runs one.
get_app_rules- The rules for a TeamOnly app: the supported stack, how to read the signed-in person, the database, files, secrets, email, scheduled jobs and roles. The AI reads them before writing code.
init- Creates a starter app or one of the templates in an empty folder, or adds TeamOnly to an app you already have.
deploy- Builds the app and puts it online at its private address, behind your company login.
status- Who is signed in, your company’s plan, and every app with its address and who can open it.
logs- Watches the live app for 5 to 60 seconds and returns its requests,
console.logoutput and errors. access- Shows or changes who can open the app: everyone at the company, or only the people on a list.
roles- Shows or changes the roles people have inside the app, like approver or finance.
set_secret- Stores an API key or password for the app, so it never goes in the code.
sign_in- Signs you in with your work email and the 6-digit code we email you.
start_trial- Starts the 14-day free trial for your company, with no card.
subscribe- Returns a payment link for the Builder, Team or Business plan.
delete_app- Deletes the live app with its data. It needs the app’s name to confirm.
Deploy this app on TeamOnlyteamonly · get_app_rulesteamonly · deployLive at https://expenses.acme.teamonly.appIt’s live. Only people with an @acme.com account can open it.04Try it
What to say
Plain words are enough. For example: Deploy this app on TeamOnly
Other things people ask:
- The app shows an error when I save. Check the logs and fix it.
- Only Priya and Sam should be able to open this.
- Make Dana an approver.
- Store my Slack webhook as a secret.
05Sign-in
How sign-in works from the agent
You never leave the chat, and you never paste a password.
Your work email
The agent asks for your work email and calls
sign_in. We email you a 6-digit code.The code
You tell the agent the code. It calls
sign_inagain and you are signed in on this computer.A new company
If your company doesn’t have TeamOnly yet, the agent can call
start_trialfor 14 days free with no card, orsubscribe, which gives you a payment link to open.
Does the MCP server replace the CLI?
No. The CLI keeps working exactly as before, and the rules files that npx teamonly init adds stay the main way your AI learns how to write a TeamOnly app. The MCP server gives the same actions to AI tools that prefer tools over terminal commands.
Where does the MCP server run?
On your computer. Your AI tool starts it with npx -y teamonly mcp and talks to it over stdio. It runs locally because deploying reads your project’s files.
Is it free?
The MCP server is part of the teamonly npm package, so there is nothing extra to buy. To deploy, your company needs TeamOnly: start the 14-day free trial with no card, or subscribe.
Which AI tools does it work with?
Any tool that runs local MCP servers: Claude Code, Cursor, VS Code, Claude Desktop, Windsurf and other agents. It is also listed in the official MCP Registry as dev.teamonly/teamonly.
Early access
Put your first tool online this week.
TeamOnly is in early access, and every plan is open now. Try it free for 14 days with no card, or subscribe. Either way, your company is ready right away, and three commands put your first app online.
Not ready? Get updates
Questions go to hello@teamonly.dev, and a person answers.