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 tree of folders, JSON files, Markdown files, and uploaded files, stored in a Mut Merkle tree.

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 appear in the content tree 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 access add notion https://notion.so/your-database-id --folder /docs

Option 3: Create content manually

Create content directly from the Dashboard editor, or use the REST API:

# Create a directory
curl -X POST "$BASE_URL/mkdir" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"path": "products"}'
 
# Write a JSON file
curl -X POST "$BASE_URL/write" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "products/widget.json",
    "content": {"name": "Widget Pro", "price": 99.99},
    "node_type": "json",
    "message": "Add product"
  }'

Where BASE_URL is https://api.puppyone.ai/api/v1/content/{project_id}.

Step 4: Connect an agent

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

puppyone access 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