डेवलपर दस्तावेज़

MCP

Claude, Codex और अन्य MCP क्लाइंट को अपनी Alt नोट्स से जोड़ें।

Alt एक होस्टेड MCP (Model Context Protocol) सर्वर प्रदान करता है। OAuth सपोर्ट करने वाले क्लाइंट browser sign-in से जुड़ सकते हैं; API keys fallback के रूप में उपलब्ध रहती हैं। दोनों तरीके समान read-only scopes और workspace सीमा लागू करते हैं।

यहाँ से शुरू करें

प्रोजेक्ट फ़ोल्डर में इंटरैक्टिव सेटअप विज़ार्ड चलाएँ। यह MCP कनेक्शन, API कुंजी और वेबहुक की जाँच तथा कोडिंग एजेंट को काम सौंपने के चरण बताता है।

npx

npx altalt --mcp-only

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 की जांच करें।
OAuth अभी केवल Alt administrators के लिए उपलब्ध है। इस upgrade के बाद कोई पुराना Alt OAuth connection authenticate न हो, तो उसे client से हटाकर एक बार फिर जोड़ें।

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

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

MCP URL

https://mcp.altalt.io/mcp

Claude / Claude Desktop / Cowork

Customize → Connectors → Add custom connector खोलें, ऊपर वाला endpoint डालें, OAuth client ID और secret खाली रखें, फिर Connect चुनें।

Claude Code

shell

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

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

Codex CLI

shell

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

config.toml

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

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

Cursor

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 इस्तेमाल करें।

OAuth

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

API key

{
  "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 लौटाते हैं, ताकि एजेंट बाद में फिर कोशिश करें।