English
Quick Start
Cloud

Cloud Quick Start

Get your agent connected to your data in 5 minutes.

Step 1: Create an account

Visit puppyone.ai (opens in a new tab) and sign up.

Step 2: Create a project

  1. After signing in, click New Project
  2. Enter a name, such as "Product Knowledge Base"
  3. Click Create

A Project is your top-level container. All data inside it is organized as a Content Node tree made up of folders, JSON, Markdown, and files.

Step 3: Import Data

Once your Project is ready, you have several ways to bring data in.

Option 1: Upload files

  1. In the Dashboard, click Import → Upload Files
  2. Drag in or select files such as PDF, Word, or Excel
  3. Wait for processing to finish; the files will be converted into Content Nodes automatically

Option 2: Connect Notion

From the Dashboard:

  1. Click Import → Notion
  2. Complete OAuth authorization
  3. Choose the pages you want to import
  4. Click Import

Or from the CLI:

puppyone sync auth notion
puppyone conn add notion https://notion.so/your-database-id --folder /docs

Option 3: Create content manually

Create content nodes directly from the CLI:

puppyone fs mkdir /products
puppyone fs touch -t json /products/widget.json
puppyone fs write /products/widget.json -d '{"name": "Widget Pro", "price": 99.99}'

You can also create and edit JSON or Markdown content manually in the Dashboard editor.

Step 4: Connect an agent

The fastest way is through MCP. First, create an MCP endpoint from the Dashboard or CLI:

puppyone conn add mcp "My Data"

After creation, you will get an MCP Server URL in the format https://api.puppyone.ai/api/v1/mcp/server/sk_live_xxx.

Using Cursor as an example, create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "puppyone": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.puppyone.ai/api/v1/mcp/server/sk_live_xxx"]
    }
  }
}

Replace sk_live_xxx with your real API key, then restart Cursor.

For other agent clients, see the distribution docs, including Claude Desktop, Claude Code for file sync, and the REST API.

Step 5: Test it

In Cursor or Claude Desktop, ask:

"Help me look up our product data."

If everything is configured correctly, the agent will call PuppyOne and fetch the data.

Next steps

IntroductionSelf-Hosted