McpService
MCP access: tokens for your own AI tools (any MCP client) to drive the Studio you have open in your browser, your Studio sessions and the calls they made.
On this page
- Summary
- Methods
- CreateMcpToken
- ListMcpTokens
- RevokeMcpToken
- ListStudioSessions
- ListMcpCalls
- Types
- CreateMcpTokenRequest
- CreateMcpTokenResponse
- ListMcpCallsRequest
- ListMcpCallsResponse
- ListMcpTokensRequest
- ListMcpTokensResponse
- ListStudioSessionsRequest
- ListStudioSessionsResponse
- McpCall
- McpScope
- McpToken
- McpTokenRef
- StudioSession
- See also
MCP access: let your own AI tools (any Model Context Protocol client) drive the NEO Studio you have open in your browser. You make a token per client in Settings → MCP access, choosing what it may do (its scopes); the client connects to {api}/mcp/studio with Authorization: Bearer neomcp_..., and the platform relays its calls to a Studio you're signed in to. Calls that need a scope the token lacks for deleting, publishing or launching processes wait for you to allow them in the Studio's MCP Connections panel. Tokens are shown once, stored only as a hash, and can be revoked at any time. Every method is a POST with a JSON body; see the overview for the protocol, authentication and errors.
Summary#
| Method | Auth | Description |
|---|---|---|
| CreateMcpToken | Account | Makes a token (shown once). Scopes beyond read, edit and build (fs, destructive, publish, process, secrets.write) need you to confirm it's you first: a passkey or authenticator step-up when the account has one, otherwise the account's password. |
| ListMcpTokens | Account | Your tokens, newest first (never the tokens themselves). |
| RevokeMcpToken | Account | Revokes a token: its next call is refused, and calls of it waiting in a Studio are dropped. |
| ListStudioSessions | Account | Your Studio sessions that accept MCP clients (open now, and the last few days'), newest first. |
| ListMcpCalls | Account | The MCP calls your tokens made, newest first. |
Methods#
CreateMcpToken#
Makes a token (shown once). Scopes beyond read, edit and build (fs, destructive, publish, process, secrets.write) need you to confirm it's you first: a passkey or authenticator step-up when the account has one, otherwise the account's password.
POST /neo.platform.v1.McpService/CreateMcpToken
Content-Type: application/jsonAuth: A signed-in account. Guests are refused.
Request: CreateMcpTokenRequest. Response: CreateMcpTokenResponse.
ListMcpTokens#
Your tokens, newest first (never the tokens themselves).
POST /neo.platform.v1.McpService/ListMcpTokens
Content-Type: application/jsonAuth: A signed-in account. Guests are refused.
Request: ListMcpTokensRequest. Response: ListMcpTokensResponse.
RevokeMcpToken#
Revokes a token: its next call is refused, and calls of it waiting in a Studio are dropped.
POST /neo.platform.v1.McpService/RevokeMcpToken
Content-Type: application/jsonAuth: A signed-in account. Guests are refused.
Request: McpTokenRef. Response: ListMcpTokensResponse.
ListStudioSessions#
Your Studio sessions that accept MCP clients (open now, and the last few days'), newest first.
POST /neo.platform.v1.McpService/ListStudioSessions
Content-Type: application/jsonAuth: A signed-in account. Guests are refused.
Request: ListStudioSessionsRequest. Response: ListStudioSessionsResponse.
ListMcpCalls#
The MCP calls your tokens made, newest first.
POST /neo.platform.v1.McpService/ListMcpCalls
Content-Type: application/jsonAuth: A signed-in account. Guests are refused.
Request: ListMcpCallsRequest. Response: ListMcpCallsResponse.
Types#
CreateMcpTokenRequest#
| Field | Type | Description |
|---|---|---|
name | string | who it's for ("Claude Code on my laptop") |
scopes | array of string | read is always included |
expiresInDays | number | 0: never expires; at most 365 |
password | string | the account's password, when sensitive scopes are asked for and the account has no passkey or authenticator |
CreateMcpTokenResponse#
| Field | Type | Description |
|---|---|---|
token | McpToken | |
secret | string | Bearer neomcp_...: shown once |
endpoint | string | where MCP clients connect |
ListMcpCallsRequest#
| Field | Type | Description |
|---|---|---|
limit | number | up to 200 (default 50) |
before | string | the last call of the previous page's at (older calls come next) |
tokenId | string | only this token's (mct_...) |
ListMcpCallsResponse#
| Field | Type | Description |
|---|---|---|
calls | array of McpCall |
ListMcpTokensRequest#
| Field | Type | Description |
|---|---|---|
includeInactive | boolean | include revoked and expired tokens |
ListMcpTokensResponse#
| Field | Type | Description |
|---|---|---|
tokens | array of McpToken | |
scopes | array of McpScope | every scope a token may have |
endpoint | string | where MCP clients connect |
ListStudioSessionsRequest#
No fields: send {}.
ListStudioSessionsResponse#
| Field | Type | Description |
|---|---|---|
sessions | array of StudioSession |
McpCall#
| Field | Type | Description |
|---|---|---|
at | string | |
tokenId | string | mct_... |
tokenName | string | |
sessionId | string | mss_... (empty: none was reached) |
method | string | tools/call, tools/list, resources/read,... |
tool | string | the tool, for tools/call |
outcome | string | ok, error, refused, held, timeout, no_studio, rate_limited, too_large |
ms | number |
McpScope#
| Field | Type | Description |
|---|---|---|
name | string | |
description | string | |
heldWithout | boolean | calls needing it wait for you in the Studio when the token lacks it (instead of being refused) |
sensitive | boolean | asking for it needs a confirmation that it's you |
McpToken#
| Field | Type | Description |
|---|---|---|
id | string | mct_... |
name | string | |
prefix | string | the token's first characters (neomcp_...), to tell tokens apart |
scopes | array of string | read, edit, fs, build, destructive, publish, process, secrets.write |
createdAt | string | |
lastUsedAt | string | empty: never used |
expiresAt | string | empty: never expires |
revokedAt | string | empty: active |
calls | string (int64) |
McpTokenRef#
| Field | Type | Description |
|---|---|---|
tokenId | string |
StudioSession#
| Field | Type | Description |
|---|---|---|
id | string | mss_... |
title | string | |
project | string | |
connectedAt | string | |
lastSeenAt | string | |
closedAt | string | empty: open now |
live | boolean | |
recentTokenIds | array of string | the tokens that called it in the last day (mct_...) |
endpoint | string | its own endpoint (pins this session) |