CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 7 of 16

Secrets

How passwords and logins reach you instead of the assistant, and what reveal_to_agent changes.

On this page

When a tool would answer a secret the Control Panel holds, the secret goes to you, not to the assistant. The assistant gets a link to a page in the Control Panel, and you open it in your browser.

This covers:

  • database credentials, and database user passwords;
  • administrator logins, including the first login of a new site, login resets and one-time login links;
  • password protection logins and preview logins;
  • generated SSH passwords;
  • deployment variable values;
  • browser terminal recordings;
  • a performance audit's share link.

The secret page

  1. The assistant calls the tool. Your client opens the link, or the assistant shows it to you.
  2. Sign in to the Control Panel, with your two-factor code.
  3. Choose Show to see the secret, or Don't show to decline.
RuleValue
Link lifetime15 minutes
UsesOne
Who can open itOnly the person whose token or app made the call

A tool that resets a login, creates an administrator or sets an SSH password changes nothing until you choose the button, which then reads Reset and show, Create and show or Set and show.

Give a secret to the assistant

The assistant receives the value only when both are true:

  • the grant holds the exec scope;
  • the call sets reveal_to_agent: true.
json
{
  "name": "corestack_db_credentials_get",
  "arguments": {
    "site_id": 1042,
    "reveal_to_agent": true
  }
}

An assistant should set it only when you ask for the value to be given to it. The value is then in the tool result only: it is never stored in the activity log.

One-time logins

A new site's administrator login can be shown once, to whoever reveals it first, in the Control Panel or through MCP. After that the call answers already_revealed, and the assistant can offer a reset with corestack_admin_login_reset.

Values that are never returned

Some values go in and never come back, such as a deployment registry token. Their read tools answer whether a value is set and its last four characters.

What is not a secret

Site files and command output are not hidden. A grant with read can read any file in a site, including configuration files that hold passwords.

Limit a grant and Safety say how to narrow that.

Was this helpful?
Open in ClaudeOpen in ChatGPT