مثنوی معنوی

Claude.ai (web)

1. Sign in at claude.ai.
2. Settings → Connectors → Add custom connector.
3. Name masnavi · URL https://masnavi.ai/mcp · save.

Requires Claude Pro / Team / Enterprise.

Claude Desktop

Newer builds: Settings → Connectors → Add custom connector. Or edit the config file directly:

{
  "mcpServers": {
    "masnavi": { "type": "http", "url": "https://masnavi.ai/mcp" }
  }
}

ChatGPT — Custom GPT (any Plus plan)

Easiest path. Works on standard Plus, no Developer Mode needed:

1. chatgpt.com → your name (top-right) → My GPTs → Create.
2. In the editor, click the Configure tab.
3. Scroll to Actions → Create new action.
4. Schema → Import from URL → paste https://masnavi.ai/api/openapi.json.
5. Authentication: None. Privacy policy URL: https://masnavi.ai/.
6. Save the GPT. Use it: "Verify the beyt «بشنو این نی…» using the action."

ChatGPT — Native MCP (Pro / Business / Enterprise / Edu)

If you have one of these tiers and prefer the MCP transport:

1. Settings → Connectors → Advanced → enable Developer Mode if needed.
2. Add custom connector · MCP URL https://masnavi.ai/mcp · auth None.

Gemini — via REST API

The consumer Gemini app doesn't accept arbitrary MCP servers yet, but Gemini's function-calling and Gemini CLI accept either MCP or REST:

1. Gemini CLI: edit ~/.gemini/settings.json, use the httpUrl form (snippet below).
2. Gemini API / Google AI Studio: add the OpenAPI spec at https://masnavi.ai/api/openapi.json as a custom tool. Or use plain HTTP from your function-calling code.
3. Gems / Workspace: not yet — Google hasn't shipped arbitrary tool import for those.

Cursor & VS Code

One click: ↗ Add to Cursor ↗ Add to VS Code

Gemini CLI — config snippet

Edit ~/.gemini/settings.json (note: Gemini uses httpUrl):

{
  "mcpServers": {
    "masnavi": { "httpUrl": "https://masnavi.ai/mcp" }
  }
}

Plain curl / any HTTP client

curl 'https://masnavi.ai/api/search?q=عشق&limit=3'
curl 'https://masnavi.ai/api/lookup?citation=M1:1'
curl 'https://masnavi.ai/api/verify?text=بشنو این نی چون شکایت می‌کند'

REST is GET-only, public, returns JSON. See the full spec at /api/openapi.json, browse at /api/docs.

Anything else (Cline, Continue, Roo, Windsurf, custom code)

MCP — streamable HTTP, no auth:

{
  "mcpServers": {
    "masnavi": { "type": "http", "url": "https://masnavi.ai/mcp" }
  }
}

Or call the REST API directly. Both surfaces speak the same nine tools.