operator-setup

Authenticate Operator Editor MCP access by reading .operator files and updating OPERATOR_SESSION_ID.

Updated Oct 8, 2025
One-click install
npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill operator-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: operator-setup
Source: https://github.com/ichabodcole/project-docs-scaffold-template/tree/main/plugins/operator/skills/operator-setup
Command: npx skills add https://github.com/ichabodcole/project-docs-scaffold-template --skill operator-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Operator Setup helps users configure and authenticate Operator Editor MCP access, enabling secure session management for editing and syncing documents.

Core Features & Use Cases

  • Detects missing or expired Operator sessions and guides first-time setup.
  • Reuses existing MCP sessions within a 24-hour window to minimize re-authentication.
  • Provides clear instructions for creating and persisting credentials via a .operator file.

Quick Start

Create or update a .operator file with your credentials to start an authenticated Operator MCP session.

Frequently Asked Questions about operator-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate Operator Editor MCP access for secure document editing?

To authenticate Operator Editor MCP access, you apply the operator-setup process during first-time setup, which validates your session via OPERATOR_API_KEY and updates the OPERATOR_SESSION_ID for secure document editing.

What is an Operator MCP session and when do I need to re-authenticate?

An Operator MCP session enables secure document editing and syncing. You need to re-authenticate when your session is missing, expired, or outside the 24-hour reuse window across projects.

How do I configure a .operator file for MCP session setup?

You configure a .operator file by creating or updating it with your credentials, specifically the OPERATOR_API_KEY, to start an authenticated Operator MCP session and persist your access.

Can I reuse an existing MCP session across multiple projects?

Yes, you can reuse existing MCP sessions across projects within a 24-hour window to minimize re-authentication, provided the session remains valid and has not expired.

Why does my Operator MCP setup fail to validate my session?

Operator MCP setup fails to validate your session if the .operator file is missing credentials, the OPERATOR_API_KEY is invalid, or the OPERATOR_SESSION_ID has expired outside the 24-hour window.