Zorya Context

Connect Context to your AI

Help your AI do better work with Context knowledge. You will need a free StartZorya account and an AI tool that supports remote HTTP MCP. Create a personal token, connect Context, and try it on your own task.

Ask your AI agent to connect Context

Copy the link into a chat with your agent. It will first check whether Context is already connected and whether it can access client settings.

Prompt for your agent
Read the current instructions at https://startzorya.com/en/install#agent-setup and the applicable project instructions. First check whether Zorya Context is connected and its tools are available. If not, check whether you can safely change the client settings. Preserve the existing configuration and make only the smallest necessary change; do not replace the whole file. Enter a token only through a protected settings field or secrets store—never ask for it in chat or put it in the project or logs. After setup, verify that the Context tools are available and report the actual result. If you lack the required access or a secure way to enter the token, stop and tell me what I need to do.

Do not put tokens or passwords in prompts or AI chats.

Choose a first example

1. Account and personal token

Create an account. Give the connection a name you will recognize and issue a token. This secret key lets your AI tool access Context. Its full value is shown only once: save it immediately in protected storage. If you close or hide it, check your connection list first.

2. Choose a connection method

Use only the authenticated account MCP connection below. Context reads the public library. Keep personal and project documents in your AI host chat or workspace. Never put personal information, secrets, or private project content in public profile name, scope, or topics. The host controls conversation memory; MCP cannot guarantee its isolation or deletion.

MCP server URL
https://startzorya.com/mcp/context-account

The free beta includes all 13 Context tools: the catalog, knowledge selection and preparation, research, personal knowledge sessions and export. Research and exports require separate consent. Document import is unavailable in the account MCP. Model and external-service charges are separate. Large context uses more input tokens, so start with a lightweight compatible model and one small question.

Enter the Bearer token in the MCP client’s protected authorization settings; public mcp.json contains no credentials and does not configure them for the client. The server alias is zorya_context_account. The package version is sent in X-Zorya-Context-Client-Version. For Codex CLI use codex mcp add zorya_context_account --url https://startzorya.com/mcp/context-account --bearer-token-env-var ZORYA_CONTEXT_TOKEN. In Cursor, set the version header statically and Authorization through a protected environment variable.

Manual
  1. Open MCP settings and add a remote HTTP server.
  2. Set the name to zorya_context_account and use the server URL above.
  3. In a protected header field, set Authorization: Bearer <your token>. Do not paste the value into a chat.
  4. Restart the MCP session and refresh the tool list.

The client must support remote HTTP MCP and secure Bearer-token handling.

Codex CLI 0.163.0

First make ZORYA_CONTEXT_TOKEN available to the Codex CLI process environment. The command passes the variable name, not the token value.

Codex CLI 0.163.0
codex mcp add zorya_context_account --url https://startzorya.com/mcp/context-account --bearer-token-env-var ZORYA_CONTEXT_TOKEN

Restart Codex after setup and check the MCP tool list. This command is for Codex CLI; a separate desktop client depends on its version and environment.

Cursor

Add the zorya_context_account entry in MCP settings. Keep any other entries already in mcpServers. The ${env:ZORYA_CONTEXT_TOKEN} syntax is supported for remote MCP headers; the variable must be available to the Cursor process that opens the connection. Restart Cursor and refresh the tools.

Cursor
{
  "mcpServers": {
    "zorya_context_account": {
      "url": "https://startzorya.com/mcp/context-account",
      "headers": {
        "Authorization": "Bearer ${env:ZORYA_CONTEXT_TOKEN}",
        "X-Zorya-Context-Client-Version": "0.3.4"
      }
    }
  }
}

envFile applies to stdio servers, not this remote HTTP server.

Cursor
Bash · hidden token input
read -r -s -p "Zorya Context token: " ZORYA_CONTEXT_TOKEN
export ZORYA_CONTEXT_TOKEN
printf '\n'

Run these commands in the same terminal from which you start the client. read -s hides the token while you type; the token value is not written in the command. After starting the client, run unset ZORYA_CONTEXT_TOKEN when you no longer need the variable.

An environment variable is available only to processes that inherit it when they start. A terminal, an app launched from the desktop menu, an SSH session, WSL, and a remote client may have different environments. Set the variable in the environment of the process that opens the MCP connection, then restart that process; a value set in a local terminal is not automatically available to a desktop app, SSH, WSL, or remote environment.

Optional integration package

Download /downloads/zorya-context-account-beta.tar.gz. It contains a Russian README, plugin.json and mcp.json, and the public Zorya Context skill in English. This English setup guide stands on its own.

Download package (.tar.gz)

Start with a short request

Open the guide and choose one small example. This lets you check the connection and judge the result before trying a longer workflow.

Choose a first example

Three more useful prompts

Review an API change
Review an API change
Use catalog and read to find material about API compatibility. Review my plan: which clients may depend on the old contract? Separate supported facts from assumptions; name sources and gaps. Do not start research or change code.
Compare two approaches
Compare two approaches
Find relevant saved knowledge and compare the two approaches I describe. State versions, applicability, tradeoffs, sources, and unknowns. Do not start new research.
Check research availability
Check research availability
First check the catalog and read relevant items. If an important gap remains, say whether research is available in this configuration. If it is, propose a goal, benefit, and duration up to 600 seconds. Do not start without my separate explicit consent.

Project instruction updates (optional)

During setup, ask the project owner whether to enable startup checks. Existing clients need a one-time reviewed setup: install the five signed files in .agents/skills/context-account/, the updater at .codex/zorya-context/update.mjs, the version marker in .codex/config.toml, and bootstrap it. An old client cannot run an updater it does not have. Public MCP configuration contains the server URL and package version, not a token or automatic credential setup; configure Bearer in the client’s protected settings.

  1. Download the current zorya-context-account-beta.tar.gz package and review its contents. Do not enable project startup checks if you do not want automatic instruction updates.
  2. Copy README.ru.md, mcp.json, plugin.json, and release.json to .agents/skills/context-account/; copy skills/context-account/SKILL.md as .agents/skills/context-account/SKILL.md. Copy scripts/update.mjs to .codex/zorya-context/update.mjs.
  3. In .codex/config.toml, preserve the existing protected Bearer configuration. Under [mcp_servers.zorya_context_account.http_headers], add a separate managed version marker using the version in the installed release.json (for example 0.3.4) in the exact template format.
  4. From the project root, run node .codex/zorya-context/update.mjs --bootstrap once. After it confirms the verified current version, manually add the startup block from this guide to AGENTS.md, preserving its existing rules. Later, run --check-and-update before other work in this project.
  5. For a portable package copy, keep the signed files in the archive layout and run node scripts/update.mjs --bootstrap once from the package root; use the same command with --check-and-update for later checks.

For a portable package copy, preserve the archive layout and run node scripts/update.mjs --bootstrap once from its root. Later project checks use node .codex/zorya-context/update.mjs --check-and-update; portable checks use node scripts/update.mjs --check-and-update.

The updater verifies the bounded release at https://startzorya.com/assets/zorya-context-client-release.json using its pinned Ed25519 signature and hashes. In project mode it changes the five signed files and managed version marker in .codex/config.toml; unknown files are preserved. Managed-file edits and signature/hash errors stop the update. Offline, keep the last verified version and report the failed check. The updater bootstrap itself needs separate manual review.

.codex/config.toml
[mcp_servers.zorya_context_account.http_headers]
# BEGIN ZORYA CONTEXT CLIENT VERSION
"X-Zorya-Context-Client-Version" = "0.3.4"
# END ZORYA CONTEXT CLIENT VERSION
AGENTS.md
## Zorya Context trusted startup updates

This project owner has enabled the installed Zorya Context updater. Before dependent work, immediately run `node .codex/zorya-context/update.mjs --check-and-update` without another confirmation. Keep success silent; report only failures or required user action. It verifies the bounded release at `https://startzorya.com/assets/zorya-context-client-release.json` with the pinned Ed25519 key and hashes. It updates only the five signed files under `.agents/skills/context-account/` (`plugin.json`, `mcp.json`, `release.json`, `README.ru.md`, `SKILL.md`) and the managed version-header block in `.codex/config.toml`. Preserve unknown files and all existing project instructions. It never changes Bearer tokens, private/global settings, or application code. Stop on edits to managed files or signature/hash errors. If offline, keep the last verified version and report that the check did not complete. Updating the updater bootstrap itself requires manual review. After actual managed-file changes, reread the installed skill and refresh cached MCP schemas or reconnect. If the verified local package is current but the connection reports an old or unknown version, reconnect once and report a persistent mismatch instead of looping.

Updates

Server-side MCP tools update centrally. If the owner already enabled an installed trusted updater, the agent runs its check immediately before dependent work, without another confirmation. Success stays silent; report only failures, missing setup or required action. After actual file changes, reread the skill and refresh cached schemas or reconnect. If the local verified version is current but the connection reports an old or unknown version, reconnect once; report a persistent mismatch instead of looping updates. Without configured updates, never install a bootstrap or change settings automatically. The server cannot change host files itself or guarantee compliance with this instruction.

  • The account MCP provides 13 tools without document import.
  • Research, export, jobs, and KnowledgeSession remain available.
  • Instructions clarify public profiles and host conversation memory.

Package version 0.3.4. X-Zorya-Context-Client-Version identifies the package but does not replace acceptedBundleFormats: [1, 2]. Set that field only on supported new-request schemas; preserve returned next unchanged. Correct a confirmed rejected or not-accepted request only within its original consent and remaining time, without resetting the deadline; resolve an uncertain submission by exact retry first. A stale schema requires the trusted update and reconnect. Client updates cannot enable server-disabled collection; available V1 knowledge remains reusable.

Troubleshooting

401 · token not accepted

Check the URL, Bearer scheme, and variable in the client process environment. In your account, check the prefix, expiry, and status. Do not send the token to support or in chat.

403 · access denied

Check beta and account status. Issuing another token does not remove a pause or restriction.

429 · too many requests

Wait, reduce concurrency and retries. Do not issue extra tokens to bypass the limit.

No tools appear

Restart the MCP session and refresh the list. Check that your client version supports remote HTTP MCP and the token method you chose.

No relevant knowledge was found

Every new research task requires separate explicit consent after explaining the gap, benefit, and duration. For work up to 600 seconds use context_get_research; a new task over 600 seconds, including long reuse_only preparation, needs separate approval and context_get_long. Continue an approved job with the same jobId and budget.