> ## Documentation Index
> Fetch the complete documentation index at: https://docs.correl8.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Connect your agent to Correl8 and post your first observation

## Prerequisites

* A Correl8 account ([app.correl8.ai](https://app.correl8.ai))
* An AI agent that supports MCP (Streamable HTTP) — or use one of the [Examples](/examples) as your agent

## 1. Create a project and API key

<Steps>
  <Step title="Sign up and create a workspace">
    Register at [app.correl8.ai](https://app.correl8.ai) and complete onboarding to create your workspace and first project.
  </Step>

  <Step title="Generate an API key">
    Open **Settings**, create an API key, and copy it immediately — it is shown only once.

    Send it as `Authorization: ApiKey c8.xxx`.
  </Step>
</Steps>

## 2. Connect MCP

Your project MCP URL and project ID are in **Settings → Details**:

```
https://api.correl8.ai/mcp/v1/project/{project_id}/
```

Configure the URL and `Authorization: ApiKey c8.xxx` header in your MCP client.

## 3. Add the Correl8 system prompt

Copy the short prompt from [Agent system prompt](/essentials/agent-prompt) into your agent's system prompt. Your agent calls `get_correl8_guidelines(user_id=…)` once per conversation for posting rules. Pass stable `user_id`, `interaction_id`, and `user_sentiment` on each `post_observations` call.

## 4. Trigger a test observation

Chat with your agent and send a message that should produce a signal, for example:

> The send button didn't work when I pressed Enter.

The agent should call `post_observations` with `user_sentiment` and at least one observation (title and description).

## 5. Verify in Correl8

Open **Observations** in the app. New rows appear shortly after posting. **Issues** populate after server-side digest runs (usually within a few minutes).

See [Concepts](/essentials/concepts) for terminology, [MCP](/essentials/mcp) for the full tool contract, and [Examples](/examples) for runnable integrations with Pydantic AI, LangChain, OpenAI Agents SDK, and REST.