Before you begin
Sign up for an AgentWeb account at app.agentweb.pro/register if you don’t have one. For Claude Code and OpenClaw, generate an API key:- Open app.agentweb.pro.
- Go to Settings → API Keys.
- Click Generate.
aw_. Keep them secret.
Claude.ai uses OAuth and does not require an API key. Other MCP clients can also use OAuth when they support browser authorization and PKCE. Codex uses a plugin generated by Plugin Creator.
1
Add Emma as a connector
- Claude.ai (Recommended)
- Claude Code
- Codex
- OpenClaw
- Open claude.ai and go to Settings → Connectors.
- Click Add custom connector.
- Fill in the fields:
- Name:
Emma - MCP server URL:
https://api.agentweb.pro/mcp
- Name:
- Click Connect. Claude.ai redirects you to AgentWeb’s authorization screen.
- Sign in to AgentWeb if prompted.
- Review the scopes being granted, then click Authorize.
- Use Emma’s MCP tools on your behalf
- Read AgentWeb data (campaigns, content, leads, schedules)
- Send messages on connected accounts (LinkedIn, Gmail, etc.)
- Manage schedules and run workflows
2
Use Emma in any chat
Open a conversation in your connected client. Emma’s tools are available automatically. Try:
- “Emma, what’s in my brand guidelines?”
- “Pull my latest Meta campaign performance and tell me what to cut.”
- “Draft three LinkedIn posts in my founder voice about [topic].”
- “Search my CRM for leads who haven’t replied in two weeks.”
OAuth from a remote or headless client
Some OAuth-capable MCP clients run on a different machine from your browser. They may print an authorization URL instead of opening a browser automatically.- Start the client’s OAuth connection command in a persistent terminal or PTY. Keep that process and its standard input open.
- Open the authorization URL in your browser.
- Sign in to AgentWeb, review the requested access, and approve the connection.
- AgentWeb redirects the browser to a loopback URL such as
http://127.0.0.1:<port>/callback?code=...&state=.... - If the browser cannot open that page, copy the complete URL from the address bar. The connection failure is expected when the browser and MCP client are on different machines.
- Return the complete callback URL to the original waiting process using the client’s callback-paste or standard-input mechanism.
- Complete any tool-selection prompt, then use the client’s connection test or server list to verify that Emma’s tools were discovered.
Verify the connection
Paste this prompt into any session with Emma to confirm tools are wired up correctly:Verify Emma is connected
Troubleshooting
Claude Code: connection refused or timeout
Claude Code: connection refused or timeout
- Confirm the endpoint URL is
https://api.agentweb.pro/mcpwith no trailing slash. - Test the key by calling the endpoint with
curland the same authorization header. A 200 response confirms the key works. - Some corporate networks block Streamable HTTP. Try a different network to rule this out.
Claude Code: tools don't appear
Claude Code: tools don't appear
- Run
claude mcp listto confirm the server is registered. - If missing, run
claude mcp remove emmaand the add command again. - Restart Claude Code. MCP servers load when a session starts.
Codex: tools don't appear
Codex: tools don't appear
- Confirm the Emma plugin is installed and enabled in Codex.
- Open the plugin and confirm MCP server URL is
https://api.agentweb.pro/mcp. - Start a new Codex thread. MCP tools are loaded when a thread starts.
- If the plugin was created with the wrong URL, create it again in Plugin Creator with the values above.
OpenClaw: skill file doesn't load
OpenClaw: skill file doesn't load
- Open
https://api.agentweb.pro/skill.mdin a browser to confirm it returns markdown. - Confirm the API key in OpenClaw matches the one in the portal. Whitespace counts.
- “Unknown tool” errors usually mean a stale skill file. Reload it.
Revoke a leaked API key
Revoke a leaked API key
- Go to Settings → API Keys in the portal.
- Click Revoke on the compromised key.
- Click Generate to create a new key.
- Update Claude Code (
claude mcp remove emma, then add again) or OpenClaw with the new key.
Next steps
- Set up your brand profile before using Emma.
- Agent Mode reference for how Emma uses your Knowledge Base.

