Skip to content

admin-mcp.mdx

Latest commit

 

History

History
167 lines (125 loc) · 6.54 KB

admin-mcp.mdx

File metadata and controls

167 lines (125 loc) · 6.54 KB

import { Callout } from 'nextra/components'

Admin MCP Server (BETA)

BETA

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.

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).

Installing

Cursor

Install MCP Server **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

Install on VS Code **Manual Install**: ```bash code --add-mcp '{"name":"Hellō Admin","url":"https://admin-mcp.hello.coop","type":"http"}' ``` See [VS Code guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server) for more information.

Claude Code

Using the Claude CLI: ```bash claude mcp add hello-admin http https://admin-mcp.hello.coop/ ``` 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.
See Claude Desktop Guide 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.
See Gemini CLI Guide for more information.

Goose

Install in Goose

Manual Install:
Advanced settings → Extensions → Add custom extension and paste the HTTP Transport config.
See Example guide for more information.

LM Studio

Add MCP Server hello-admin to LM Studio

Manual Install:
Program → Install → Edit mcp.json and paste the HTTP Transport config.
See LM Studio for more information.

Qodo Gen

Manual Install:
Open the chat panel → Connect more tools → Add new MCP → Paste the Stdio Transport config config.
See Qodo Gen for more information.

Don’t see your tool listed? File an issue and we’ll add support.

Manual

From Source:
Clone the repo and follow the instructions at hellocoop/admin-mcp.

HTTP Transport (Remote - Recommended):

{
  "hello-admin-http": {
    "url": "https://admin-mcp.hello.coop/",
    "type": "http"
  }
}

NPM Package (Local - Most compatible):

{
  "hello-admin-stdio": {
    "command": "npx",
    "args": ["-y", "@hellocoop/admin-mcp@latest"],
    "type": "stdio"
  }
}
You will need Node 18 installed for the local version.

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 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.

For local development, testing, and advanced usage, visit the Admin MCP Server GitHub repo.