Installation

Overview

Notery integrates with AI coding assistants through two methods: downloadable agent skills and a hosted MCP server. Both give your tools access to notery_search and notery_get so they can query your workspace documentation directly.

Prerequisites

Before setting up either method, you need an API key. Create one from your workspace's Settings page. See API Keys for details.

Method 1: Agent Skills

Download a self-contained skills package and add it to your project.

1. Open your workspace and navigate to the Skills page.
2. Download the skills zip file.
3. Extract it into your project root. This creates a notery/ folder containing SKILL.md and fetch.py.

Set the required environment variables:

export NOTERY_API_KEY="ntry_your_key_here"
export NOTERY_API_URL="https://notery.dev"

Then use the /notery command in your coding agent to search and retrieve documents.

Method 2: MCP Server (Recommended)

The MCP server connects your AI tools directly to your Notery workspace with no downloads required. This is the recommended approach for tools that support MCP.

Claude Code

claude mcp add --transport http notery https://notery.dev/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "notery": {
      "url": "https://notery.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "notery": {
      "type": "http",
      "url": "https://notery.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf / Other

Most MCP-compatible tools accept a similar configuration format:

{
  "mcpServers": {
    "notery": {
      "type": "http",
      "url": "https://notery.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Refer to your tool's documentation for the exact config file location.

Verifying the Connection

Once configured, ask your AI assistant to search your Notery workspace:

"Search my Notery docs for getting started"

If the connection is working, you will see results from your workspace documents. If you get an authentication error, double-check that your API key is correct and has not been revoked.