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

# Connect an AI agent

> Two ways to connect an agent to Social Monitor Hub: MCP (preferred) or the HTTP Open API.

An agent needs one URL and one API key. Start at [Quickstart](https://monitor-docs.solobiz.academy/agents/quickstart.md). Every page here is also available as markdown: add `.md` to the URL. Whole docs index: `/llms.txt`.

## Pick a connection

| Your agent | Use | Page |
| - | - | - |
| Claude Code | MCP | [Connect Claude Code](https://monitor-docs.solobiz.academy/agents/connect-claude-code.md) |
| Codex CLI | MCP | [Connect Codex](https://monitor-docs.solobiz.academy/agents/connect-codex.md) |
| Cursor, Claude Desktop, other MCP clients | MCP (JSON config) | [Connect via MCP JSON](https://monitor-docs.solobiz.academy/agents/connect-mcp-json.md) |
| Hermes Agent, GrokBot | MCP (YAML or JSON config) | [Connect Hermes and GrokBot](https://monitor-docs.solobiz.academy/agents/connect-hermes-grokbot.md) |
| MausBot, custom scripts, no MCP client | HTTP Open API | [Connect HTTP bots](https://monitor-docs.solobiz.academy/agents/connect-http-bots.md) |

MCP and HTTP use the same key, permissions, error codes and 120 requests per minute limit.

## Key roles

| Role | Can do |
| - | - |
| `viewer` | Read channels, posts, comments, inbox status |
| `editor` | Everything viewer can, plus publish, cancel, reply, hide, mark handled |

Create keys in the Hub (workspace admin only). The key is shown once. The Hub also generates a ready-to-paste connect prompt: see [Prompt templates](https://monitor-docs.solobiz.academy/agents/prompt-templates.md).

## Next

* [MCP tools](https://monitor-docs.solobiz.academy/agents/mcp-tools.md): all 15 tools
* [Publishing workflow](https://monitor-docs.solobiz.academy/agents/publishing-workflow.md)
* [Comment inbox loop](https://monitor-docs.solobiz.academy/agents/comment-inbox-loop.md)
* [Safety rules](https://monitor-docs.solobiz.academy/agents/safety-rules.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.