# Cloud-hosted Intelligence

> Sign in, create a project, and connect your runtime with a project API key.

## Overview [#overview]

Cloud-hosted Intelligence runs the platform for you, with a project and an API key and no cluster to operate. Your app still uses the CopilotKit SDK.

![The cloud-hosted Intelligence ready page.](/react-native/mastra/images/cloud-hosted/cloud-hosted-ready.png)

The cloud-hosted service stores the project's threads, events, and API keys. You create the project once, connect your app with the CLI, and everything else is in the web app.

The web app is for the people who build and operate the app. The people who chat with your agent do not sign in there. Your app still identifies those people and passes that identity through the runtime.

Compare this deployment with self-hosted on the [architecture page](/react-native/mastra/intelligence/intelligence-platform).

## Get started [#get-started]

Start at [intelligence.copilotkit.ai](https://intelligence.copilotkit.ai) or in the CopilotKit CLI.

<Steps>
  <Step>
    ### Sign in [#sign-in]

    Select **Start cloud-hosted setup** and sign in. If this is a new account, accept the CopilotKit Self-Service Agreement.

    <OpsPlatformCTA
      variant="inline"
      title="Start cloud-hosted setup"
      body="Sign in, create an organization, then return to the CLI or the web app and select a project."
      ctaLabel="Start cloud-hosted setup"
      href="https://intelligence.copilotkit.ai/"
      surface="docs_intelligence_managed_platform_intro"
    />

    A new organization chooses the Developer plan or a paid plan. Developer is the no-cost plan. Read [Plans](/react-native/mastra/intelligence/plans) when you want to change that choice.
  </Step>

  <Step>
    ### Create or select an organization [#create-or-select-an-organization]

    Select an organization in the browser, or create one.
  </Step>

  <Step>
    ### Return to the tool that sent you [#return-to-the-tool-that-sent-you]

    After the organization step, the browser returns to the CLI or the web app that opened it. If the CLI opened the browser, return to the terminal and let the command continue.
  </Step>

  <Step>
    ### Select or create a project [#select-or-create-a-project]

    A project holds one app or one environment. Create a separate project for production, staging, demos, and experiments. Their API keys and threads stay separate.

    Sign in and select the project in the [quickstart](/react-native/mastra/intelligence/quickstart#select-an-intelligence-project). That page writes `CPK_INTELLIGENCE_API_KEY` to `.env`.

    Two other commands fit a different starting point:

    - `npx copilotkit@latest create` creates a new app and writes the same key.
    - `npx copilotkit@latest skills onboard` adds CopilotKit to an existing app.
  </Step>
</Steps>

The [CopilotKit CLI](/react-native/mastra/cli) uses the same sign-in. The first `login` opens a browser sign-in page and stores a local session. Later commands reuse that session. `project select` creates the project API key and writes it to `.env`.

![The cloud-hosted project list.](/react-native/mastra/images/cloud-hosted/cloud-hosted-projects.png)

Choose a project to open its **Overview**. The project navigation groups its pages into two areas:

- **Overview**, **Product Analytics**, and **Automatic Learning** show project activity and analysis. On the Developer plan, features that are a limited trial are marked **TRIAL**.
- **Project resources** contains [Threads](/react-native/mastra/AG-UI-Streams), [Channels](/react-native/mastra/intelligence/channels), [User Memories](/react-native/mastra/intelligence/memories), and [API Keys](#create-an-api-key).

Each page is scoped to the selected project. Its project API key connects your runtime to that same project.

Inside a project, open **Threads** to find the conversations saved for that project.

![A cloud-hosted project and its threads.](/react-native/mastra/images/cloud-hosted/cloud-hosted-thread-list.png)

Open one thread to read its event timeline.

![A cloud-hosted thread with its event timeline.](/react-native/mastra/images/cloud-hosted/cloud-hosted-thread-detail.png)

The thread page shows the agent, the app user, the status, the last update time, and the event timeline. Open an event when you need the raw payload. **Rename**, **Archive**, and **Delete** match the thread API in your app: archive hides the thread from the active list and keeps the history, delete removes it. Read [AG-UI Streams](/react-native/mastra/AG-UI-Streams) for how a thread works in your app.

## Create an API key [#create-an-api-key]

A project API key connects your runtime to this project. The [quickstart](/react-native/mastra/intelligence/quickstart#select-an-intelligence-project) writes it to `.env` as `CPK_INTELLIGENCE_API_KEY`. `init` or its `create` alias writes the same key when it creates an app.

Cloud-hosted setup does not issue `COPILOTKIT_LICENSE_TOKEN`. A license key is only for a self-hosted deployment. It does not replace the project API key.

Keep `CPK_INTELLIGENCE_API_KEY` on the server.

![The cloud-hosted API keys page.](/react-native/mastra/images/cloud-hosted/cloud-hosted-api-keys.png)

The CLI writes the full key into `.env`. A later run of `project select` creates another key for the same project. Deleting a key stops every app that still uses it.

Connect the key in the [quickstart](/react-native/mastra/intelligence/quickstart).

## Next [#next]

- [Plans](/react-native/mastra/intelligence/plans) shows limits and how to change the plan.
- [Self-host Intelligence](/react-native/mastra/intelligence/self-hosting) when the platform must run in your cluster.
