MCP connector
Vinssi serves a remote MCP server at https://mcp.vinssi.ai/mcp. Add that URL as a custom connector. The server speaks Streamable HTTP. Sign-in is OAuth through Clerk at https://clerk.vinssi.ai. This page is also in Finnish.
The connector acts as you, in your workspace. It can read the workspace, list and create projects, connect a GitHub repository, deploy, read deployment status and build logs, roll back a healthy deployment, and publish or delete Vinssi Pages. It does not expose secret-management tools. Build logs redact known environment values and recognizable credentials before returning bounded output. Avoid writing secrets to application logs. It does not start checkout. If a project needs a plan, the tool says so and links to vinssi.ai/pricing.
Repository deploys are GitHub only. The Vinssi GitHub App has to be installed and allowed to see the repository. connect_repo takes owner/name. A repository on another host cannot be connected.
Add the connector
Use https://mcp.vinssi.ai/mcp as the server URL. When the client opens a browser, sign in to Vinssi and approve the request.
Claude
In Claude, open Settings, then Connectors, and add a custom connector. Paste https://mcp.vinssi.ai/mcp. Claude's redirect URL is https://claude.ai/api/mcp/auth_callback. Claude Code also uses a loopback redirect on http://localhost or http://127.0.0.1 at any port, path /callback.
ChatGPT
In ChatGPT, turn on developer mode for apps if the account requires it, then add a connector by URL. Paste https://mcp.vinssi.ai/mcp. The redirect URL ChatGPT shows for this flow is https://chatgpt.com/connector_platform_oauth_redirect. A review submission may also show https://chatgpt.com/connector/oauth/{callback_id} from the OpenAI dashboard. That callback id is specific to the submission.
Cursor
In Cursor, open Settings, then MCP, and add a server by URL. Paste https://mcp.vinssi.ai/mcp. The same URL works in an MCP config file:
{
"mcpServers": {
"vinssi": {
"url": "https://mcp.vinssi.ai/mcp"
}
}
}
Cursor opens a browser for OAuth. A client that can only send a header can use a personal API token instead. See API and tokens.
Grok Bot
In Grok Bot, add a custom MCP connector and paste https://mcp.vinssi.ai/mcp. If the form asks for a server URL rather than a plugin repository, that address is the server.
Tools
| Tool | What it does |
|---|---|
get_workspace | Workspace name and remaining credit, in euro cents |
list_projects, get_project | Projects, status, GitHub repository, live URL |
create_project | Creates an empty project. It does not deploy |
connect_repo | Connects owner/name from the GitHub App. Replaces an existing connection |
deploy | Queues a deployment of the connected GitHub repository. Optional git ref |
get_deployment, get_build_logs, list_deployments | Status, the latest build log lines, recent deployments |
rollback | Queues a new deployment that restores a previous healthy one |
publish_page | Publishes files sent in the request and returns the live URL |
list_pages, delete_page | Lists sites, or deletes one |
publish_page takes files, each with path and content. encoding is utf8 (the default) or base64. The limit is 200 files and 5 MB of decoded content. A single HTML file is stored as index.html. Multiple files require index.html at the root; invalid input is rejected before a site is created. name is required for a new site. Pass siteId to replace what that URL serves. The previous version stays stored.
get_build_logs returns the last 200 lines unless you set tail. The maximum is 400 lines and about 64 KB of log data. Oversized individual messages are omitted. truncated indicates omitted output.
Limits
Limits are per workspace and shared with the dashboard, the CLI, and direct API calls.
| Action | Limit |
|---|---|
| Deploy and rollback | 20 per 5 minutes |
| Page publish | 60 per 5 minutes |
Personal API token
OAuth sign-in is still being verified with these clients. If it does not complete, or the client can only send a header, use a personal API token. Create it with vinssi tokens create in your own terminal and enter it privately in the client as Authorization: Bearer vinssi_..., never in an AI conversation. See API and tokens.
A request with no token gets 401 and a WWW-Authenticate header that points at the metadata URL.
Authorization
Clients find the sign-in server in the protected-resource metadata at
https://mcp.vinssi.ai/.well-known/oauth-protected-resource/mcp. It names Clerk at
https://clerk.vinssi.ai as the authorization server.
OAuth access tokens must be JWT access tokens issued by https://clerk.vinssi.ai
for exactly the MCP URL you connected to: the token's audience must be
https://mcp.vinssi.ai/mcp. A token without an audience, or for another address,
is rejected. Opaque access tokens, session tokens and ID tokens are rejected too.
No custom scope is needed: the server advertises the standard openid and
offline_access scopes; any standard scopes are accepted, and the exact
audience is what grants MCP access.
Missing or invalid tokens return 401 with a WWW-Authenticate challenge.
Each request is authorized separately against your workspace.
OAuth sign-in works only at https://mcp.vinssi.ai/mcp. The earlier address
https://vinssi.ai/mcp still accepts vinssi_ API tokens; its sign-in metadata
points at https://mcp.vinssi.ai/mcp.