MCP

Claude connector से कनेक्ट करें

Alt अब Claude connector directory में सूचीबद्ध है, इसलिए ज़्यादातर लोगों को नीचे दिया endpoint छूने की ज़रूरत नहीं। Claude में Customize → Connectors खोलें, Alt खोजें और Connect चुनें।

• Alt की consent screen पर access approve करें और वह एक workspace चुनें जिसे connector पढ़ सकेगा — आपके personal notes, या कोई एक team space।
• कुछ paste नहीं करना है और कोई API key नहीं बनानी। Claude खुद OAuth से register हो जाता है।
• paid plan वाला Alt account चाहिए। Free account consent screen तक पहुँचते हैं, लेकिन approve करने पर plan_required error मिलती है।
• डिज़ाइन से read-only: यह notes list करता है और transcript व summary पढ़ता है, कभी लिखता नहीं। account console से कभी भी हटाया जा सकता है।

1. OAuth से जोड़ें (सुझाया गया)

बिना headers के केवल endpoint जोड़ें। आपका क्लाइंट Alt authorization server खोजता है, खुद को register करता है और browser consent screen खोलता है।

• Alt Dynamic Client Registration और PKCE सपोर्ट करता है, इसलिए compatible clients OAuth अपने आप configure करते हैं।
• Access approve करने से पहले browser में मांगे गए read-only scopes और workspace की जांच करें।
• कनेक्ट करने के लिए paid plan वाला Alt account चाहिए। Free account consent screen तक पहुँचते हैं, लेकिन approve करने पर plan_required error मिलती है।

2. अपना क्लाइंट जोड़ें

OAuth के लिए केवल URL वाली configuration इस्तेमाल करें। OAuth client ID या secret की जरूरत नहीं है; API key तभी इस्तेमाल करें जब आपका क्लाइंट OAuth पूरा न कर सके।

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Custom connector केवल किसी दूसरे Alt environment से जुड़ने के लिए उपयोग करें: Customize → Connectors → Add custom connector खोलें, ऊपर वाला endpoint डालें, और OAuth client ID व secret खाली रखें।

Claude Code

claude mcp add --transport http alt https://mcp.altalt.io/mcp

Server जोड़ने के बाद Claude Code में /mcp खोलें, Alt चुनें और browser authentication पूरा करें।

Codex CLI

codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt

# ~/.codex/config.toml
[mcp_servers.alt]
url = "https://mcp.altalt.io/mcp"

Server जोड़ने पर आम तौर पर browser authentication पूरा हो जाता है। अगर authentication शुरू न हो, तो codex mcp login alt चलाएँ।

Cursor

केवल URL वाला one-click install। Cursor की MCP settings में Connect या Needs authentication चुनें और browser consent approve करें।

अन्य clients और API-key fallback

पहले केवल URL वाली OAuth config इस्तेमाल करें। अगर client MCP OAuth सपोर्ट नहीं करता, तो Bearer API-key config इस्तेमाल करें।

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp",
      "headers": { "Authorization": "Bearer alt_live_..." }
    }
  }
}

Automation और पुराने clients के लिए API keys उपलब्ध रहती हैं। अकाउंट कंसोल में key बनाएँ, केवल जरूरी scopes दें, उसे shared config में न रखें और key प्रबंधन के लिए Security देखें।

3. टूल्स

चार read-only टूल, जो REST API को दर्शाते हैं और वही scopes लागू करते हैं।

• list_notes — Key को दिखने वाली नोट्स की सूची — cursor pagination और updated_after फ़िल्टर के साथ (notes:read)।
• get_note — एक नोट का metadata: शीर्षक, ट्रांसक्रिप्ट/सारांश की स्थिति, timestamps (notes:read)।
• get_note_transcript — समय और वक्ता लेबल वाले सेगमेंट के रूप में पूरी ट्रांसक्रिप्ट (transcripts:read)।
• get_note_summary — AI सारांश Markdown में (summaries:read)।

नोट्स तब दिखती हैं जब रिकॉर्डिंग समाप्त हो जाए या सारांश बन जाए — केवल मेमो वाली नोट्स export नहीं होतीं। सामग्री तैयार होने से पहले टूल transcript_not_ready / summary_not_ready लौटाते हैं, ताकि एजेंट बाद में फिर कोशिश करें।