nynch-mcp-server: Instructions file for Codex

Nynch MCP Server

A hosted Model Context Protocol (MCP) server that gives AI agents full access to Nynch, the AI CRM for consultants and fractionals.

Website: www.nynch.com · Developer docs: www.nynch.com/developers · Endpoint: https://app.nynch.com/mcp

Repository: Configuration and documentation for the Nynch MCP Server endpoint. Version: 3.1.0 Transport: JSON-RPC 2.0 over Streamable HTTP Endpoint: https://app.nynch.com/mcp

The older endpoint https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server still answers, but it is deprecated. Use https://app.nynch.com/mcp in new configs.

---

Company Policy and Working Preferences

See nynch-OS AGENTS.md and standards/WORKING_WITH_PETER.md. Durable lessons go in this repo (or nynch-OS), never only in a tool's private memory.

---

Quick Start

Claude (custom connector, OAuth, no API key)

In Claude, open Settings → Connectors → Add custom connector and enter https://app.nynch.com/mcp. Click Connect, sign in with your Nynch account and approve access. Revoke access any time in Nynch under Settings → Integrations → AI hosts.

Other MCP clients (API key)

Get an API Key

Sign up at www.nynch.com, then go to Settings → Integrations → Claude & AI Assistants and create an API key.

Scopes:

• read — Search, browse, and retrieve data
• read-write — Read + create, update, delete records
• admin — Full access including agent orchestration

Configure Your Client

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://app.nynch.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://app.nynch.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}