From 8cba92d768b994647437cf31d4e2be86fc4ce1b5 Mon Sep 17 00:00:00 2001 From: Rune Olsen Date: Tue, 14 Jul 2026 10:33:50 +0200 Subject: [PATCH] Document External MCP Servers, Personal Data Tools, and Research Agents in Help Adds three new Help sections covering the 2.4.1 features: connecting external stdio MCP servers, Calendar/Reminders/Location access with its approval flow, and parallel read-only research sub-agents. Also notes French as a supported language and that OpenRouter's dedicated image models are merged into the model picker automatically. Cleans up a stray misplaced HTML comment above the Anytype section. Co-Authored-By: Claude Sonnet 5 --- .../Contents/Resources/en.lproj/index.html | 111 +++++++++++++++++- 1 file changed, 109 insertions(+), 2 deletions(-) diff --git a/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html b/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html index dfd00e2..9d32f91 100644 --- a/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html +++ b/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html @@ -36,6 +36,9 @@
  • Shortcuts (Prompt Templates)
  • Agent Skills (SKILL.md)
  • Anytype Integration
    • +
  • External MCP Servers
    • +
  • Personal Data Tools
    • +
  • Research Agents
  • Bash Execution
  • iCloud Backup
  • Reasoning / Thinking Tokens
    • @@ -49,7 +52,7 @@

    Getting Started

    -

    oAI is a powerful AI chat assistant that connects to multiple AI providers including OpenAI, Anthropic, OpenRouter, and local models via Ollama. The app is available in English, Norwegian BokmΓ₯l, Swedish, Danish, and German β€” it follows your macOS language preference automatically.

    +

    oAI is a powerful AI chat assistant that connects to multiple AI providers including OpenAI, Anthropic, OpenRouter, and local models via Ollama. The app is available in English, Norwegian BokmΓ₯l, Swedish, Danish, German, and French β€” it follows your macOS language preference automatically.

    Quick Start

    @@ -115,6 +118,10 @@
  • 🧠 Thinking β€” models that support reasoning / thinking tokens
    • +
    + Note: On OpenRouter, dedicated image-generation models (e.g. Sourceful, Seedream, Flux) are fetched from OpenRouter's separate images catalog and merged into the picker automatically β€” you don't need to configure anything extra to see them. +
    +

    Sorting

    Click the ↑↓ Sort button to sort the list by:

      @@ -1370,7 +1377,6 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
    -

    Anytype Integration

    @@ -1413,6 +1419,104 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
    + +
    +

    External MCP Servers

    +

    Connect any external MCP server that speaks the stdio JSON-RPC protocol (for example safaridriver --mcp) and give the AI access to its tools β€” no custom integration code needed.

    + +

    Adding a Server

    +
      +
    1. Press ⌘, to open Settings
      2. +
    2. Go to the MCP tab β†’ External MCP Servers section
      3. +
    3. Click Add Server…
      4. +
    4. Enter a Name (used to prefix its tools, e.g. "Safari" β†’ safari_navigate_to_url), the Command to launch it, and any Arguments
      5. +
    5. Click Add β€” the server starts automatically and its tools are discovered
      6. +
    + +
    + πŸ’‘ Tip: Arguments containing spaces can be quoted, e.g. --root "/Users/you/My Documents". +
    + +

    Server Status

    +

    Each configured server shows a status dot and label:

    +
      +
    • 🟒 Connected β€” running and its tools are available to the AI
      • +
    • 🟠 Connecting… β€” starting up or performing the initial handshake
      • +
    • πŸ”΄ Error / Crashed β€” failed to start or exited unexpectedly
      • +
    • βšͺ Not started β€” disabled via the toggle
      • +
    +

    Toggle a server off/on or delete it entirely with the trash icon. Crashed servers automatically restart up to 3 times with increasing delay (5s, 15s, 30s) before giving up.

    + +
    + Note: Tool names from every external server are prefixed with that server's slug (derived from its Name) so they never collide with oAI's built-in tools or each other. +
    +
    + + +
    +

    Personal Data Tools Beta

    +

    Let the AI access your Calendar, Reminders, and Location & Maps to answer questions about your schedule and surroundings. Each service is opt-in and uses Apple's own frameworks (EventKit, CoreLocation, MapKit) with standard macOS permission prompts β€” nothing goes through a third-party service.

    + +

    Enabling a Service

    +
      +
    1. Press ⌘, to open Settings
      2. +
    2. Go to the MCP tab β†’ Personal Data section
      3. +
    3. Toggle on the services you want: Calendar, Reminders, or Location & Maps
      4. +
    4. Click Request Access next to a service β€” macOS shows its standard permission prompt
      5. +
    + +

    What the AI Can Do

    +
      +
    • Calendar β€” list your calendars and upcoming events, create new events
      • +
    • Reminders β€” list reminder lists and items, create new reminders, mark reminders complete
      • +
    • Location & Maps β€” get your current location, search for places, geocode addresses, and get directions (all read-only)
      • +
    + +
    + ⚠️ Write actions require approval: Creating a calendar event or reminder, or completing a reminder, shows an approval sheet first with a plain-language summary of what will happen. Choose Deny, Allow Once, or Allow for Session. Toggle this requirement off in Settings β†’ MCP β†’ Personal Data β†’ Require Approval for Changes. +
    + +
    + Note: Contacts support exists internally but is currently hidden while a macOS permission bug affecting hardened-runtime apps is worked out on Apple's side. +
    + +

    Example Prompts

    +
      +
    • "What's on my calendar tomorrow?"
      • +
    • "Remind me to call the dentist on Friday at 2pm"
      • +
    • "How far is the nearest coffee shop from here?"
      • +
    +
    + + +
    +

    Research Agents

    +

    For tasks that involve searching or reading many files, the AI can spawn several read-only research sub-agents that work in parallel instead of doing everything itself, one step at a time.

    + +
    + ⚠️ Cost warning: Each sub-agent runs its own full chain of model calls. A single request that spawns several agents can cost several times a normal reply. Leave this off unless you specifically want that tradeoff. +
    + +

    Enabling Research Agents

    +
      +
    1. Press ⌘, to open Settings
      2. +
    2. Go to the MCP tab β†’ Research Agents section
      3. +
    3. Toggle Enable Research Agents on
      4. +
    4. Adjust Max Concurrent Agents (1–5, default 3) to control how many sub-agents can run at once
      5. +
    + +

    What Sub-Agents Can Do

    +

    Sub-agents are intentionally limited to read-only investigation β€” they cannot write files, run shell commands, or spawn further sub-agents:

    +
      +
    • Read file contents
      • +
    • List directory contents
      • +
    • Search for files
      • +
    • Search the web
      • +
    + +

    Intended for genuinely independent research tasks (e.g. "compare these five files" or "look into three unrelated topics"), not everyday questions β€” the AI is instructed to reserve this for cases that actually benefit from parallelism.

    +
    +

    Keyboard Shortcuts

    Work faster with these keyboard shortcuts.

    @@ -1490,6 +1594,9 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
  • Enable/disable write, delete, move, and bash execution permissions
  • Configure gitignore respect
  • Bash Execution β€” enable AI shell access, set working directory, timeout, and approval behaviour (see Bash Execution)
    • +
  • Research Agents β€” let the AI spawn parallel read-only research sub-agents (see Research Agents)
    • +
  • External MCP Servers β€” connect any stdio MCP server for additional tools (see External MCP Servers)
    • +
  • Personal Data β€” Calendar, Reminders, and Location & Maps access (see Personal Data Tools)

    • Sync Tab