CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 4 of 16

Scopes

The default set of MCP scopes, the tools that need Destructive, and the calls that need more than one scope.

On this page

A scope says what a grant may do. The MCP server uses the API's four, read, write, exec and destructive: Scopes says what each allows.

Every tool's description names the scope it needs.

The default set

A new token and a first approval of an app have Read, Write and Exec ticked. Destructive is not ticked for you, even when the app asks for it.

Destructive lets the assistant delete production sites and clusters.

Destructive tools

These tools always need destructive:

Not every deletion is on this list. Some tools remove something for good with write, such as a role: read the scope in each tool's description.

Conditional scopes

Some calls need an extra scope, on top of the tool's own, when a condition holds.

When the callIt also needsTools
Overwrites a production environmentdestructivecorestack_site_clone, corestack_restore_create, corestack_snapshot_restore_to, corestack_db_import, corestack_site_rewrite_urls, corestack_site_rewrite_urls_restore
Sets delete_extraneous on productiondestructivecorestack_files_sync
Retries a site delete, an environment delete or a copy onto productiondestructivecorestack_operation_retry
Sets reveal_to_agent: trueexecEvery tool that can answer a secret: see Secrets
Asks for the download of a database exportexeccorestack_transfer_get
Reads or cancels a taskEvery scope the call that started the task neededcorestack_task_get, corestack_task_cancel

Node.js packages add one condition.

When the callIt also needsTools
Turns Node.js install scripts on for a packageexeccorestack_node_packages_update, corestack_node_runtime_copy, corestack_site_clone

A deployment pipeline adds one condition.

The server checks the whole set once, so a missing scope is asked for in one go.

When a scope is missing

GrantWhat happens
OAuth connectionThe app reopens the approval page with the scopes the call needs ticked. Approve, and the app retries.
Personal tokenThe call answers scope_required with a link that opens Edit restrictions with the scope added. Save, then ask the assistant to retry.

Adding a scope needs your two-factor code: see Sign in and tokens.

Was this helpful?
Open in ClaudeOpen in ChatGPT