import { Callout } from 'nextra/components'

# Admin MCP Server (BETA)

<div>
  <img src="https://cdn.hello.coop/images/beta-label.png" alt="BETA" className="beta-label"/>
</div>

The Admin MCP server lets you create and manage your Hellō applications directly from your AI assistant, including uploading logos for both light and dark themes.

<Callout type="warning">
This MCP server is currently in BETA, but it is safe to try out as it is not able to make destructive changes. Help us improve the server by filing [issues or making suggestions](https://github.com/hellocoop/admin-mcp/issues).
</Callout>

## Installing

### Cursor

<span className="mt-4 block"/>
<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=hello-admin&config=eyJ1cmwiOiJodHRwczovL2FkbWluLW1jcC5oZWxsby5jb29wIn0K" className="inline-block">
  <img src="https://cursor.com/deeplink/mcp-install-light.svg" alt="Install MCP Server" className="border rounded-md" />
</a>
<span className="-mb-2 block"/>
**Manual Install**:  
Cursor Settings → MCP → Add new MCP Server. Use type `http` and URL `https://admin-mcp.hello.coop/`.  
See [Cursor guide](https://docs.cursor.com/context/mcp#installing-mcp-servers) for more information.

### VSCode

<span className="mt-4 block"/>
<a href="vscode:mcp/install?%7B%22name%22%3A%22Hell%C5%8D%20Admin%22%2C%22url%22%3A%22https%3A//admin-mcp.hello.coop%22%2C%22type%22%3A%22http%22%7D" className="inline-block">
  <img src="https://img.shields.io/badge/Install%20on-VS%20Code-007ACC" className="h-6" alt="Install on VS Code" />
</a>
<span className="-mb-2 block"/>
**Manual Install**:
<span className="-mb-4 block" />
```bash
code --add-mcp '{"name":"Hellō Admin","url":"https://admin-mcp.hello.coop","type":"http"}'
```
<span className="-mt-4 block" />
See [VS Code guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server) for more information.


### Claude Code
<span className="-mb-2 block" />
Using the Claude CLI:
<span className="-mb-4 block" />
```bash
claude mcp add hello-admin http https://admin-mcp.hello.coop/
```
<span className="-mt-4 block" />
See [Claude guide](https://docs.anthropic.com/en/docs/claude-code/mcp) for more information.

### Claude Desktop
**Manual Install**:  
Navigate to Connector Settings → Add a Custom Connector → Paste the [HTTP Transport config](#manual).  
See [Claude Desktop Guide](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server) for more information.

### Gemini CLI
**Manual Install**:  
Create `.gemini/settings.json` in your project's root directory → Add `mcpServers` block → Paste the [HTTP Transport config](#manual).  
See [Gemini CLI Guide](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#configure-the-mcp-server-in-settingsjson) for more information.

### Goose
<span className="mt-4 block"/>
<a href="https://block.github.io/goose/extension?cmd=http&arg=https%3A%2F%2Fadmin-mcp.hello.coop%2F&id=hello-admin&name=Hell%C5%8D%20Admin&description=Manage%20your%20Hell%C5%8D%20apps%20via%20MCP" className="inline-block">
  <img src="https://block.github.io/goose/img/extension-install-dark.svg" className="h-7 border border-white/25 rounded-md" alt="Install in Goose" />
</a>

**Manual Install**:  
Advanced settings → Extensions → Add custom extension and paste the [HTTP Transport config](#manual).    
See [Example guide](https://docs.pieces.app/products/mcp/goose) for more information.

### LM Studio
<span className="mt-4 block"/>
<a href="https://lmstudio.ai/install-mcp?name=hello-admin&config=eyJ1cmwiOiJodHRwczovL2FkbWluLW1jcC5oZWxsby5jb29wIn0K">
  <img src="https://files.lmstudio.ai/deeplink/mcp-install-light.svg" alt="Add MCP Server hello-admin to LM Studio" />
</a>

**Manual Install**:  
Program → Install → Edit mcp.json and paste the [HTTP Transport config](#manual).  
See [LM Studio](https://lmstudio.ai/blog/lmstudio-v0.3.17#add-mcp-servers-to-lm-studio) for more information.

### Qodo Gen

**Manual Install**:  
Open the chat panel → Connect more tools → Add new MCP → Paste the [Stdio Transport config](#manual) config.  
See [Qodo Gen](https://docs.qodo.ai/qodo-gen/tools-mcps/agentic-tools-mcps) for more information.

---

Don’t see your tool listed? [File an issue](https://github.com/hellocoop/hello.dev/issues) and we’ll add support.

---

### Manual

**From Source**:  
Clone the repo and follow the instructions at [hellocoop/admin-mcp](https://github.com/hellocoop/admin-mcp#local-development).

**HTTP Transport (Remote - Recommended)**:
```json
{
  "hello-admin-http": {
    "url": "https://admin-mcp.hello.coop/",
    "type": "http"
  }
}
```

**NPM Package (Local - Most compatible)**:  
```json
{
  "hello-admin-stdio": {
    "command": "npx",
    "args": ["-y", "@hellocoop/admin-mcp@latest"],
    "type": "stdio"
  }
}
```
<Callout type="info">
You will need Node 18 installed for the local version.
</Callout>

## Supported Functionality

We only add one tool to your environment, `hello_manage_app`, keeping you under any tool limits imposed by your IDE or CLI. All functionality is exposed as actions by that tool.


Actions:

* `create` – Create new applications with smart defaults
* `read` – Retrieve application or profile details
* `update` – Update app settings (redirect URIs, names, etc.)
* `create_secret` – Generate OAuth client secrets
* `update_logo_from_data` – Upload a logo using base64 data
* `update_logo_from_url` – Upload a logo via public URL

Each response includes:

* Your user profile (name, email, picture)
* Your teams and organizations, along with assigned roles
* All apps associated with your teams
* Current team and app state


## Security
- Short-lived tokens (1-hour expiration)
- Access scoped to create, read, update. Destructive actions are intentionally restricted.

## Current Limitations
- Cannot delete applications (use [Hellō Console](https://console.hello.coop) for deletion)
- Token requires re-authentication after 1 hour of inactivity


## Getting Help & Contributing

**We want your feedback!** This MCP server is in beta and we're actively improving it.

- **Documentation**: [MCP Server Repository](https://github.com/hellocoop/admin-mcp)
- **Report Issues**: [GitHub Issues](https://github.com/hellocoop/admin-mcp/issues)
- **Contribute**: [Submit Pull Requests](https://github.com/hellocoop/admin-mcp/pulls)
- **Community**: [Join our Slack Community](https://hello-community.slack.com/join/shared_invite/zt-1eccnd2np-qJoOWBkHGnpxvBpCTtaH9g#/shared-invite/email)

---

For local development, testing, and advanced usage, visit the [Admin MCP Server GitHub repo](https://github.com/hellocoop/admin-mcp).