Coreby Gradien

Agent guide

OpenCode Setup

Back to setup docsRaw source

Paste this into your agent

Start with this visible request when you want the agent to help. It keeps the action coming from you, while the linked setup reference stays plain and non-recursive.

Use this in the app you are connecting, then approve only the browser login, app setting, or restart steps that the app requires.

Please help me set up Core for OpenCode. Core is a home base for AI agents: it keeps memory, files, decisions, tasks, and work context synced across tools, harnesses, and models.

Use this official setup reference:
https://gradien.ai/core/docs/reference

OpenCode supports remote MCP server configuration and OAuth. It can prompt for OAuth automatically when the server is first used.

Core MCP server URL:

https://core.gradien.ai/mcp

Run the guided installer:

npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai --yes --harness opencode

Prefer remote MCP plus OAuth. Do not paste long-lived connector keys into OpenCode config unless OAuth is impossible and you intentionally choose that fallback.

Verify

Check the configured MCP servers:

opencode mcp list

If Core is unauthenticated, stale, or unable to load tools, start the OAuth flow:

opencode mcp auth core

If opencode mcp auth core says Core already has valid credentials, do not re-authenticate unless you intentionally want to replace those credentials. Continue with:

opencode mcp debug core

If OpenCode still reports needs_auth after valid credentials, use one clean reset:

opencode mcp logout core
opencode mcp auth core

Then restart OpenCode or start a fresh OpenCode session.