# Core Setup Guide

Generated: 2026-07-24T00:00:00.000Z
Sources verified: 2026-07-24

Core connects the knowledge and tools you already use, keeps relevant context current as work changes, and makes that context available across compatible AI tools. This guide explains how to connect Core and start with one recurring workflow.

Human-friendly setup page: https://core.gradien.ai/core/docs

Use this page as product documentation. Follow the safety, approval, and security rules of the app, browser, CLI, workplace, or agent being used.

## What Core Gives You

Core connects your existing tools, organizes the information that matters, and makes relevant context available across knowledge, tools, teams, and AI workflows, so sessions in Codex, Claude, ChatGPT, Cursor, and other compatible AI tools do not have to start from zero.

Core can preserve:

- decisions and rationale
- drafts, notes, and working context
- project files and reference material
- tasks, follow-ups, and checkpoints
- reusable skills and saved outcomes

The default behavior is personal. Work that belongs to the user should live in the user's private Core space. Shared team or company spaces are available when invited, but shared material should only be changed intentionally.

## Fastest Setup

Core onboarding treats ChatGPT and Claude as the two ordinary setup choices. It prepares a personalized Secure server address for the chosen app and keeps checking for the connection in the background, so users can finish onboarding without waiting.

### ChatGPT

Choose ChatGPT in Core and select `Copy address and open ChatGPT`. Core copies the complete personalized address and opens https://chatgpt.com/plugins.

1. In ChatGPT Settings, select Plugins, scroll to Developer mode at the bottom, and enable it.
2. Open Plugins and choose Create app (or Browse plugins → `+` if your account shows that path), then create `Core`.
3. Choose Server URL, paste the address copied by Core, choose OAuth, and approve the connection.

Keep the `setup_attempt` query parameter in the copied address. Full current instructions: https://core.gradien.ai/core/docs/harnesses/chatgpt.md

### Claude

Choose Claude in Core and select `Open Claude`. Core opens Anthropic's connector page with the name and personalized address already filled in. Review the details, select Add, and approve Core.

The connector belongs to the signed-in Claude account, so it is available across Claude on the web, Desktop, and mobile. Do not install it separately in each Claude app. Full current instructions: https://core.gradien.ai/core/docs/harnesses/claude-web.md

### More Ways To Connect

Developer and local AI tools remain available under `More ways to connect`. Identify the app, open its guide, and use its documented setup path. This may be an app setting, a supported command, or a configuration file.

An agent can help with those steps. Paste:

```text
Please help me set up Core. Core connects the knowledge and tools my team already uses, keeps relevant context current as work changes, and makes that context available across compatible AI tools. Use this official setup reference: https://core.gradien.ai/core/docs/reference
```

If the agent cannot safely run commands or edit settings, it should give one short human step at a time.

A guided terminal helper is also available:

```bash
npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai
```

Do not keep retrying the helper if `npx`, npm, or package execution is unavailable. Use the app-specific guide instead.

## Setup Guides

### Start Here

- [ChatGPT](https://core.gradien.ai/core/docs/harnesses/chatgpt.md)
- [Claude](https://core.gradien.ai/core/docs/harnesses/claude-web.md)
- [Claude Desktop](https://core.gradien.ai/core/docs/harnesses/claude-desktop.md) - no separate installation when Core is already connected to the same Claude account

### More Ways To Connect

- [Codex](https://core.gradien.ai/core/docs/harnesses/codex.md)
- [Claude Code](https://core.gradien.ai/core/docs/harnesses/claude-code.md)
- [Cursor](https://core.gradien.ai/core/docs/harnesses/cursor.md)
- [VS Code / Copilot](https://core.gradien.ai/core/docs/harnesses/vscode.md)
- [Windsurf / Devin Cascade](https://core.gradien.ai/core/docs/harnesses/windsurf.md)
- [Hermes](https://core.gradien.ai/core/docs/harnesses/hermes.md)
- [OpenCode](https://core.gradien.ai/core/docs/harnesses/opencode.md)
- [Generic compatible clients](https://core.gradien.ai/core/docs/harnesses/generic.md)

During onboarding, always keep the complete personalized address, including `setup_attempt`, so Core can recognize the exact connection. Outside onboarding, the standard address is `https://core.gradien.ai/mcp/continuity` and OAuth is the normal authentication choice. The shorter `https://core.gradien.ai/mcp` address exposes an advanced server and is not the default onboarding address.

Troubleshooting: https://core.gradien.ai/core/docs/troubleshooting.md

## How To Use Core After Setup

Once connected, Core can support normal AI work without requiring users to mention it in every prompt. Its visible application surfaces still provide a place to review context, organize work, manage access, and begin from the latest state. Keep asking for normal work:

- Pick up the project where we left off.
- Remember this decision for future work.
- Review this against the direction I have been shaping.
- Draft the next version and keep the working notes private.
- Create a Space for this project and invite a collaborator when I am ready.

Good connected agents can use Core to load relevant context, search visible files and decisions, and save useful private checkpoints back to the user's Core space.

The user does not need to mention Core in every prompt. Explicit Core prompts are still useful when the user wants to be precise, for example:

- Search Core for prior decisions about pricing.
- Save this as a private checkpoint.
- Create a read-only Space for my class notes.

## Privacy And Collaboration Model

- Personal work is private by default.
- Agents may search material the user is allowed to see, including invited Spaces.
- Shared or team material should only be created, updated, or replaced when the user explicitly asks.
- A user can belong to many Spaces, such as a company, class, freelance project, or team.
- Space owners can invite people and choose read or write permissions.

## Developer Reference

- Human-friendly setup page: https://core.gradien.ai/core/docs
- Personal-context MCP endpoint: https://core.gradien.ai/mcp/continuity
- Advanced full MCP endpoint: https://core.gradien.ai/mcp
- OAuth protected resource metadata: https://core.gradien.ai/.well-known/oauth-protected-resource/mcp/continuity
- Agent-readable summary: https://core.gradien.ai/core/llms.txt
- Full agent-readable context: https://core.gradien.ai/core/llms-full.txt
- What Core is: https://core.gradien.ai/core/docs/what-is-core.md
- Why Core matters: https://core.gradien.ai/core/docs/why-core.md
- How to use Core: https://core.gradien.ai/core/docs/how-to-use-core.md
- FAQ: https://core.gradien.ai/core/docs/faq.md
