# Set up Knotr for your agent > This page teaches your agent how to get the most out of Knotr. Share it with your agent to finish setup after MCP is connected. | Version | | --- | | 1.0.0 | ## Introduction The user shared this guide because they want Knotr as their **context layer**: profile, skills, knowledgebases, style guides, and artifacts that carry across agents and sessions. Knotr is not chat history. It is a user-owned workspace they can read, edit, and share. Your job is to **use Knotr proactively** once setup is done, not only when they say "check Knotr." ## Rules for communicating with the user - Show **one step at a time**. Keep each message short. End with one clear next step. - Use everyday language. Assume they are new to Knotr unless they say otherwise. - Start with **why**, then how. Offer more detail only if they ask. - Prefer **two choices at most** (clickable buttons or ask-user UI when available). Do not dump long lists unless asked. - Keep going until setup is finished. After each step, guide them to the next. ## One-time setup Do these steps in order. ### 1. Confirm Knotr MCP If Knotr tools are not available, ask the user to connect Knotr MCP first (OAuth). On ChatGPT, use **Connect on ChatGPT** from Knotr Integrations if needed, open a **new main ChatGPT chat** with the setup prompt (`https://chatgpt.com/?q=…` from Integrations; plugin listing URLs do not prefill), then in that chat open **Plugins → Knotr** before they send the prompt. On Claude, add the Knotr plugin or connector from Integrations, then authorize. Call **`about-me`**. Confirm success by telling the user the **profile name** from the response. If the call fails, stop and help them finish OAuth before continuing. ### 2. Choose how much to set up Right after you confirm the connection, ask the user one question with two choices (use your platform's button UI when you have it): **"You're connected to [profile name]. How do you want to set up Knotr for your agents?"** | Option | Description | | --- | --- | | Bring what you know into Knotr (Recommended) | Save durable preferences, skills, notes, and work into this Knotr profile so every agent and session can reuse them. | | Just remember to use Knotr | Add standing instructions so future chats call Knotr without being asked. Skip importing context for now. | Remember their choice for the rest of setup. ### 3. Standing instructions (required for both choices) This is the **most important step**. Future chats must call Knotr without the user remembering. Compose the custom-instructions block using the **`standing_instructions`** field from the profile resource or from **`about-me`** (same content). Do not paste profile identity, behavior, or other **`about-me`** sections into custom instructions; those stay live in Knotr via **`about-me`**. If you cannot read it from tools, build it with the same rules as `standing_instructions` (Knotr usage rules only, no profile biography). Tell the user exactly where to paste on **this platform only**: - **Claude:** Open **Settings → Your Claude** and paste into the instructions field there. - **ChatGPT:** Click your photo or initials (bottom left) → **Personalization** → scroll to **Custom instructions** → paste there. Show the full text in one Markdown code block so they can copy it. Say: **"Once you've pasted that, tell me and we'll continue."** If your platform can save custom instructions for the user, offer to do it while keeping any existing instructions intact. ### 4. Bring context into Knotr (Recommended choice only) Skip this section if they chose **Just remember to use Knotr**. Import helpful context you can already see (built-in memory, installed skills, recent durable notes). Do **not** scan full chat transcripts or invent facts. Use these tools only: - **`update_profile`** for role, goal, domain, and assistant-behavior preferences. Do not overwrite a field silently; say what changed. - **`create_or_update_skill`** for reusable instructions worth keeping on the profile. - **`create_or_update_document`** for notes worth keeping in a knowledgebase. - **`create_or_update_artifact`** for finished documents or pages worth sharing. Never save passwords or secrets. Skip one-off progress and copied code that belongs in a repo. After each write, verify it succeeded. Tell the user what you saved and where they can open it in Knotr. ### 5. Wrap up Summarize in a few sentences: what they pasted, what you saved (with links if available), and anything they still need to do in Knotr Integrations. Ask them to **start a new chat** (or switch to another agent) and check that it already calls **`about-me`** and knows their profile without re-explaining everything. ## Reference: Knotr tools to use after setup | Tool | When | | --- | --- | | `about-me` | Once per session; full profile behavior and pointers | | `list_skills` / `get_skill` | Repeatable workflows on this profile | | `search_knowledgebase` / `get_document` | Trusted notes and files | | `check_style` | User-facing copy before shipping | | `list_artifacts` / `create_or_update_artifact` | Durable outputs that outlive the chat | | `update_profile` | Durable preference or persona changes | Setup guide URL: https://knotr.ai/prompts/setup