CI and headless

OAuth needs a browser, so automated environments use an API token instead.

Create a token

Dashboard → Settings → API tokens. Tokens look like hsk_live_… and are shown once.

Store it as a secret

Never commit it. In GitHub Actions, add it under repository Settings → Secrets and variables → Actions.

Publish in your workflow

Use the CLI, or run the MCP server over stdio if an agent is driving.

GitHub Actions

name: Publish preview
on:
  push:
    branches: [main]

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci && npm run build
      - name: Publish to htmldrop
        env:
          HTMLDROP_API_TOKEN: ${{ secrets.HTMLDROP_API_TOKEN }}
        run: npx @htmldrop.app/cli deploy
        working-directory: dist

MCP over stdio

HTMLDROP_API_TOKEN=$HTMLDROP_API_TOKEN npx -y @htmldrop.app/mcp

Direct API

If you would rather not add a Node dependency, the REST API takes the same token as a bearer credential.

Connect

Per client

GitHub Actions

MCP over stdio

Direct API

​GitHub Actions

​MCP over stdio

​Direct API

GitHub Actions

MCP over stdio

Direct API