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

# Overview

> Build with documents, projects, tables, and AI.

HERO is a collaborative document platform with built-in AI agents and native [Model Context Protocol](mcp/overview) integration.

## What you can build

* **Document automation** — programmatically create, update, and organise documents.
* **AI workflows** — invoke HERO's specialised agents from your own product.
* **MCP integrations** — let any MCP-compatible AI tool work with HERO content.
* **Realtime collaboration** — connect to realtime document states and work with others.

## Get started in 3 steps

Pick the path that matches how you're integrating.

<Tabs>
  <Tab title="REST API">
    For calling HERO REST API directly from your own code or provider.

    <Steps>
      <Step title="Generate an API key">
        Sign in at [HERO](https://app.myhero.so), open **[Settings](https://app.myhero.so/settings/account)**, and click **Generate new API key**. <br />
        Copy the `hero_ak_*` key — it's shown once.

        See [Authentication](./authentication) for the full walkthrough.
      </Step>

      <Step title="Make your first request">
        Get the default user workspace to confirm auth works:

        ```bash theme={null}
        curl https://app.myhero.so/api/workspace/default \
          -H "Authorization: Bearer hero_ak_<your-key>"
        ```

        See [Working with the API](./working-with-the-api) for conventions.
      </Step>

      <Step title="Browse the reference">
        Every public endpoint is documented in the [API reference](./api-reference).
      </Step>
    </Steps>
  </Tab>

  <Tab title="MCP (AI tools)">
    For connecting Cursor, VS Code, Claude or any MCP-compatible AI client to HERO MCP.

    <Steps>
      <Step title="Install for your client">
        One-click installers for Cursor, VS Code, and Claude Desktop are listed on [Connect HERO to your AI tool](./mcp/overview). <br />
        For other clients, the same page has a manual JSON config snippet.
      </Step>

      <Step title="Generate an MCP access token">
        Open **[MCP Settings](https://app.myhero.so/settings/mcp-tokens)** and click **Generate New Token**. <br />
        Copy the `hero_at_*` token and paste it into your client's config.

        See [MCP authentication](./mcp/authentication) for safety guidelines and the OAuth alternative when supported by your client.
      </Step>

      <Step title="Try it from your AI client">
        Ask your client something like *"list my workspaces"* to test. <br />
        The MCP server exposes 50+ tools across documents, tables, projects, and web search.

        Browse the full [Tool catalog](./mcp/tools).
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Warning>
  An API/MCP access token acts as you — anyone holding it has the same access to your account, workspaces, and documents that you do. Treat it like a password.

  * **Never commit** a token to git or paste it into chat, screenshots, issue trackers, or logs.
  * **Never embed** a token in client-side code or anything served to a browser.
  * **Never share** a token with another person or paste it into untrusted MCP clients.
  * If a token is exposed, revoke it immediately from [Account Settings](https://app.myhero.so/settings/account) and generate a new one.
</Warning>

## Need help?

File us an email at [hello@myhero.so](mailto:hello@myhero.so) or join the community **[Discord](https://discord.gg/qt6mnvkzfM)**.