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

# Cello + Bolt integration

> How to add user referrals to your app using Cello with Bolt.

Bolt can implement Cello user referrals end-to-end if you give it the **right guidance** and force it to create a plan before coding.

<img src="https://mintcdn.com/cello/9I_GJwnpy9k9Akv3/images/Group-2-1.png?fit=max&auto=format&n=9I_GJwnpy9k9Akv3&q=85&s=229740cb5f916e24c8f9ff28d9aa791b" alt="Group 2" title="Group 2" lightAlt="Group 2" darkAlt="Group 2" width="1957" height="1104" data-path="images/Group-2-1.png" />

## Prerequisites

Before integrating Cello, ensure the following prerequisites are met:

* Signup and authentication flow with a database to store user records is functional
* Stripe or Chargebee subscription flow is functional
* You have a Cello account and API keys at hand.

<Note>
  Make sure to use Cello **Sandbox environment** when developing and testing
</Note>

## Cello user referrals integration (Coding-agent flow)

<Steps>
  <Step title="Step 1">
    **Connect the Cello MCP**

    * Go to [https://bolt.new/settings?page=mcp-servers](https://bolt.new/settings?page=mcp-servers)

    * Add a Custom MCP server using the URL `https://mcp.cello.so/mcp`

    * Select MCP OAuth

    * Authenticate via the Cello Portal
  </Step>

  <Step title="Step 2">
    **Add Cello Integration Guide Skill**

    * Go to [https://bolt.new/settings?page=skills-personal](https://bolt.new/settings?page=skills-personal)

    * Add the skill from Cello's GitHub
      ```text theme={null}
      https://github.com/getcello/cello-cursor-plugin/blob/main/skills/cello-get-integration-guide/SKILL.md
      ```
  </Step>

  <Step title="Step 3">
    **Integrate Cello**

    * Use the skill to get a tailored integration guide for Cello
    * The Bolt Agent will ask you questions that cannot be answered automatically
  </Step>

  <Step title="Step 4">
    **Confirm executing the plan**

    * Review the plan carefully. If it looks correct, tell Bolt to proceed and start implementing it.
  </Step>

  <Step title="Step 5">
    **Publish & Test**

    * Run your app and test the end-to-end flow. If everything was implemented correctly,
    * You should see events coming into the [Cello Dashboard](https://portal.cello.so/dashboard/referrer).
    * Or you can validate your integration by using the Cello MCP tools and prompt "Is my Cello integration working?"
  </Step>
</Steps>

<Note>
  For a step-by-step technical implementation (source of truth + acceptance criteria), follow the detailed guide:

  * [React + Node.js Integration Guide](/resources/react-nodejs-integration)

  The guide uses React + Node.js as an example, but it can be any other combination - the steps stay the same.
</Note>