Vercel

Deploy to Vercel, which provides probably the easiest integration for Astro projects.

Vercel runs the plugin as a serverless function on the Node.js runtime. The only change from a plain plugin project is the adapter — with @quartal/plugin.

1. Install the Vercel adapter

In your plugin project (as created by pnpm create @quartal/plugin):

npm install @astrojs/vercel

2. Update `astro.config.mjs`

Replace the Node adapter with the Vercel adapter:

import { defineConfig } from "astro/config";
import vercel from "@astrojs/vercel";
import qrtlPlugin from "@quartal/plugin/astro";

export default defineConfig({
  output: "server",
  adapter: vercel(),
  integrations: [qrtlPlugin()],
});

If your project uses a widget framework, keep its integration (vue(), react(), …) in integrations — only the adapter line changes.

3. Deploy

npx vercel login     # once
npx vercel           # deploys a preview; the first run creates the project

The CLI prints a preview URL. When it looks right:

npx vercel --prod

4. Environment variables (auth plugins only)

If your plugin uses auth: "custom", set the OAUTH_* variables before deploying, once per environment:

npx vercel env add OAUTH_ISSUER

Repeat for the other variables from Authentication. Vercel keeps separate values for the production, preview and development environments — this is also the natural test/production split: previews are your test environment, --prod is production.

5. Verify

curl https://<your-deployment>.vercel.app/plugin.json

Then open the deployment URL in a browser: the docs site should show your tools, skills and agents. If routes answer 500, check the function logs in the Vercel dashboard.

Preview deployments are protected by Vercel Authentication by default: curl is redirected to a login page and API calls answer 401. Check them with npx vercel curl /plugin.json --deployment <preview-url> (which adds the project’s protection-bypass header), or disable Deployment Protection in the project settings if MCP clients need to reach previews directly.

Documentation