> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NoimosAI MCP सर्वर

> Claude, ChatGPT, Cursor और अन्य MCP-संगत क्लाइंट्स से NoimosAI का उपयोग करें।

## अवलोकन

NoimosAI MCP सर्वर आपके NoimosAI वर्कस्पेस को [Model Context Protocol](https://modelcontextprotocol.io) के माध्यम से उपलब्ध कराता है। कनेक्ट होने के बाद, MCP-संगत क्लाइंट NoimosAI एजेंट से चैट कर सकते हैं, वर्कस्पेस और इंटीग्रेशन सूचीबद्ध कर सकते हैं, और क्लाइंट के अंदर से सीधे सोशल पोस्ट प्रकाशित कर सकते हैं।

कनेक्ट करने के दो तरीके:

* **Remote MCP (अनुशंसित)** — `https://mcp.noimosai.com/mcp` पर होस्टेड। ब्राउज़र OAuth, इंस्टॉल नहीं, आपकी पहचान से चलता है।
* **Local MCP (`@agos-labs/noimosai-mcp`)** — सर्वर को npm के माध्यम से लोकल चलाएँ। हेडलेस / API-key फ़्लो के लिए उपयुक्त।

<Tabs>
  <Tab title="Remote (अनुशंसित)">
    Endpoint: `https://mcp.noimosai.com/mcp`

    ### आवश्यकताएँ

    * एक NoimosAI अकाउंट (साइन-इन किया हुआ)
    * Remote MCP / Custom Connectors समर्थन करने वाला क्लाइंट

    ### प्राधिकरण

    क्लाइंट खुद को रजिस्टर करता है, फिर ब्राउज़र खुलकर NoimosAI लॉगिन और `mcp:tools` स्कोप की सहमति माँगता है। सहमति के बाद एक एक्सेस टोकन जारी होता है और टूल कॉल आपकी पहचान से चलते हैं।

    ### सेटअप

    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        claude mcp add --scope local --transport http noimos https://mcp.noimosai.com/mcp
        ```

        सेशन के अंदर `/mcp` चलाएँ, ब्राउज़र में सहमति पूरी करें, फिर Claude Code पर लौटें।
      </Tab>

      <Tab title="Claude.ai / Desktop">
        Settings → Connectors → **Add custom connector** → URL को `https://mcp.noimosai.com/mcp` सेट करें → ब्राउज़र में साइन-इन करें और सहमति दें।
      </Tab>

      <Tab title="ChatGPT Web">
        URL `https://mcp.noimosai.com/mcp` के साथ Custom MCP connector जोड़ें, फिर सहमति पूरी करें। ChatGPT जेनेरिक `search` / `fetch` टूल्स को स्वतः नहीं खोजता — NoimosAI टूल्स को नाम से कॉल करें।
      </Tab>
    </Tabs>

    ### नोट्स

    * `post` को हमेशा पहले `dryRun: true` के साथ कॉल करें ताकि पेलोड की जाँच हो सके। `dryRun` के बिना पोस्ट वास्तविक सोशल अकाउंट पर प्रकाशित होती हैं।
    * डिसकनेक्ट करने के लिए क्लाइंट से connector हटाएँ।

    ### समस्या निवारण

    * **सहमति के लिए ब्राउज़र नहीं खुलता** — connector हटाकर फिर से जोड़ें।
    * **कोई टूल नहीं दिखता** — पुष्टि करें कि `mcp:tools` स्कोप दिया गया है और अकाउंट में कम से कम एक वर्कस्पेस है।
    * **टोकन समाप्त** — क्लाइंट से पुनः प्राधिकरण दें।
  </Tab>

  <Tab title="Local (npm)">
    npm पर [`@agos-labs/noimosai-mcp`](https://www.npmjs.com/package/@agos-labs/noimosai-mcp) के रूप में प्रकाशित। क्लाइंट की चाइल्ड प्रोसेस के रूप में चलता है।

    ### आवश्यकताएँ

    * Node.js `>= 18`
    * MCP-संगत क्लाइंट (Claude Desktop, Cursor, VS Code, …)
    * टीम सेटिंग्स से NoimosAI API key

    ### कॉन्फ़िगरेशन

    `your-api-key` और `your-workspace-id` को अपने NoimosAI टीम मानों से बदलें।

    <Tabs>
      <Tab title="Claude Desktop">
        `claude_desktop_config.json` में जोड़ें:

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="Cursor">
        `.cursor/mcp.json` में जोड़ें:

        ```json theme={null}
        {
          "mcpServers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>

      <Tab title="VS Code">
        `.vscode/mcp.json` में जोड़ें:

        ```json theme={null}
        {
          "servers": {
            "noimosai": {
              "command": "npx",
              "args": ["-y", "@agos-labs/noimosai-mcp"],
              "env": {
                "NOIMOS_API_KEY": "your-api-key",
                "NOIMOS_WORKSPACE_ID": "your-workspace-id"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>

    कॉन्फ़िगरेशन बदलने के बाद क्लाइंट को रीस्टार्ट करें ताकि MCP सर्वर लोड हो।

    ### पर्यावरण चर

    | चर                    | आवश्यक | विवरण                                                                                 |
    | --------------------- | ------ | ------------------------------------------------------------------------------------- |
    | `NOIMOS_API_KEY`      | हाँ    | NoimosAI API key (टीम सेटिंग्स के API टैब से उपलब्ध)।                                 |
    | `NOIMOS_WORKSPACE_ID` | नहीं   | जब टूल कॉल में `workspaceId` नहीं दिया जाता तब उपयोग होने वाला डिफ़ॉल्ट वर्कस्पेस ID। |
  </Tab>
</Tabs>

## टूल

दोनों ट्रांसपोर्ट एक ही टूल सेट उपलब्ध कराते हैं।

### `chat`

NoimosAI एजेंट को संदेश भेजता है। एजेंट की प्रतिक्रिया और निकाले गए सोशल पोस्ट के साथ संरचित NoimosPostJson लौटाता है। मार्केटिंग विश्लेषण, सोशल पोस्ट निर्माण, SEO और कंटेंट जनरेशन के लिए उपयुक्त।

| पैरामीटर      | प्रकार   | आवश्यक | विवरण                                                                                  |
| ------------- | -------- | ------ | -------------------------------------------------------------------------------------- |
| `prompt`      | `string` | हाँ    | एजेंट को भेजा जाने वाला संदेश या निर्देश।                                              |
| `workspaceId` | `string` | नहीं   | वर्कस्पेस ID। डिफ़ॉल्ट: `NOIMOS_WORKSPACE_ID` (Local) या प्राधिकृत अकाउंट का डिफ़ॉल्ट। |
| `sessionId`   | `string` | नहीं   | मौजूदा बातचीत जारी रखने के लिए session ID। न देने पर नया सेशन बनता है।                 |

### `list_workspaces`

उपलब्ध workspaces को ID और नाम सहित सूचीबद्ध करता है। कोई पैरामीटर नहीं।

### `list_integrations`

वर्कस्पेस से जुड़े integrations (सोशल मीडिया अकाउंट) की सूची देता है। लौटाए गए `providerAccountId` `post` टूल की प्रत्येक एंट्री के लिए आवश्यक हैं।

### `post`

सोशल मीडिया पोस्ट प्रकाशित करता है। `chat` से प्राप्त NoimosPostJson फ़ॉर्मेट के पोस्ट डेटा को स्वीकार करता है। प्रत्येक एंट्री में `providerAccountId` होना ज़रूरी है (`list_integrations` से प्राप्त करें)। प्रकाशन से पहले हमेशा `dryRun: true` से पेलोड जाँचें।

| पैरामीटर      | प्रकार    | आवश्यक | विवरण                                                                                       |
| ------------- | --------- | ------ | ------------------------------------------------------------------------------------------- |
| `posts`       | `array`   | हाँ    | NoimosPostJson फ़ॉर्मेट में posts की array। प्रत्येक एंट्री में `providerAccountId` आवश्यक। |
| `schedule`    | `string`  | हाँ    | प्रकाशन समय। तत्काल के लिए `"now"`, अनुसूचित के लिए `"YYYY-MM-DD HH:MM"`।                   |
| `workspaceId` | `string`  | नहीं   | वर्कस्पेस ID। डिफ़ॉल्ट: डिफ़ॉल्ट वर्कस्पेस।                                                 |
| `dryRun`      | `boolean` | नहीं   | `true` होने पर भेजी जाने वाली सामग्री दिखाता है पर प्रकाशित नहीं करता। डिफ़ॉल्ट: `false`.   |

## संबंधित

* [NoimosAI क्या है?](/hi/help-center/getting-started/what-is-noimosai)
* [NoimosAI CLI](/hi/developers/cli/overview)
* [npm पैकेज](https://www.npmjs.com/package/@agos-labs/noimosai-mcp)