mirror of
https://github.com/supabase/supabase.git
synced 2026-10-06 01:45:10 +03:00
Saxon FletcherandClaude Opus 5.5
a9c594a820
Renames the `mcp-server` Library block to `mcp`. Installing it now creates `supabase/functions/mcp`, so the server is served at `/functions/v1/mcp`. - Block, Edge Function folder, and docs page renamed (`/docs/headless/mcp`) - Headless App block now installs its tools into `supabase/functions/mcp` and configures `[functions.mcp]` - Links in the BYO MCP and MCP authentication guides updated - Permanent redirects keep `/r/mcp-server.json` and `/docs/headless/mcp-server` working - `public/r` rebuilt <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Updates** * The MCP Server block is now named `mcp` across its documentation, installation links, and setup instructions. * Updated function endpoints and deployment commands to use `/mcp`. * Added permanent redirects from the previous `mcp-server` documentation and install URLs to their new locations. <!-- end of auto-generated comment: release notes by coderabbit.ai --> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
85 lines
2.8 KiB
Plaintext
85 lines
2.8 KiB
Plaintext
---
|
|
title: Headless App
|
|
description: A backend with an agent as the primary interface
|
|
preview: |-
|
|
<BlockOverview name="headless-app-tanstack" showFiles>
|
|
<BlockPreview name="headless-app" />
|
|
</BlockOverview>
|
|
---
|
|
|
|
A headless app uses an AI agent as its primary interface. Users sign in and
|
|
approve access in the browser, then work through their agent using MCP tools.
|
|
This starter includes task tools and a database with Row Level Security (RLS)
|
|
that limits each user to their own data.
|
|
|
|
## Installation
|
|
|
|
Create a TanStack Start app:
|
|
|
|
```bash
|
|
pnpm dlx shadcn@latest init --template start --name my-app
|
|
cd my-app
|
|
```
|
|
|
|
Install the headless app:
|
|
|
|
<BlockItem name="headless-app-tanstack" showOpenInV0={false} />
|
|
|
|
Merge `supabase/config.toml` if you already have project settings. Add
|
|
`"supabase/functions/**"` to your app's `tsconfig.json` exclusions.
|
|
|
|
## Customize
|
|
|
|
- Set `VITE_PRODUCT_NAME` in `.env.local` and edit the generated pages and components.
|
|
- Define your tables, grants, and RLS policies in `supabase/schemas/`.
|
|
- Replace `supabase/functions/mcp/tools/tasks.ts` with your app's operations
|
|
and register them in `tools/index.ts`. Use the supplied user-scoped `supabase` client.
|
|
- Set `MCP_SERVER_NAME` and `MCP_SERVER_DESCRIPTION` with `supabase secrets set`.
|
|
|
|
## Deploy
|
|
|
|
Deploy the frontend using a [TanStack Start hosting adapter](https://tanstack.com/start/latest/docs/framework/react/guide/hosting).
|
|
Set these environment variables in your hosting provider before building:
|
|
|
|
```env
|
|
VITE_SUPABASE_URL=https://<project-ref>.supabase.co
|
|
VITE_SUPABASE_PUBLISHABLE_KEY=<publishable-key>
|
|
VITE_PRODUCT_NAME="Your app"
|
|
```
|
|
|
|
In `supabase/config.toml`, set `auth.site_url` to your deployed HTTPS origin,
|
|
update `auth.additional_redirect_urls` for your app's destinations, and set
|
|
`auth.email.enable_confirmations = true`. Keep the supplied OAuth and function settings.
|
|
Use an ES256 or RS256 signing key in your project's
|
|
[JWT Keys](https://supabase.com/dashboard/project/_/settings/jwt).
|
|
|
|
In [Email Templates](https://supabase.com/dashboard/project/_/auth/templates),
|
|
use this confirmation link for sign-up and change `type=email` to `type=recovery`
|
|
for password reset:
|
|
|
|
```html
|
|
<a
|
|
href="{{ .SiteURL }}/auth/confirm?token_hash={{ .TokenHash }}&type=email&next={{ .RedirectTo | urlquery }}"
|
|
>Confirm email</a
|
|
>
|
|
```
|
|
|
|
With the [Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started)
|
|
(2.117.0 or later) and Docker installed, generate a migration:
|
|
|
|
```bash
|
|
supabase db diff -f create_tasks
|
|
```
|
|
|
|
Review the migration, including grants and RLS policies, then deploy:
|
|
|
|
```bash
|
|
supabase link --project-ref <project-ref>
|
|
supabase db push
|
|
supabase config push
|
|
supabase functions deploy mcp
|
|
```
|
|
|
|
Open `/agents` on your deployed app, sign in, and copy the server URL into an
|
|
MCP client that supports HTTP and OAuth. Approve access to start using your tools.
|