Skip to content

Commit e7abb29

Browse files
ankur-archclaude
andauthored
docs: add fx to MCP server integrations (#8162)
* docs: add fx to MCP server integrations Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 * docs: link Vercel Labs in fx section Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 * docs: note fx tool approval prompt Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 * docs: update MCP server tool list to match the live server Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 * docs: make fx MCP steps procedural Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 * docs: sync MCP tool catalog in site server card, soften fx approval step Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 * docs: fix broken Claude Code MCP docs link Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012dnaoLgtpn2TyY1CNBxM47 --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent 6d235da commit e7abb29

2 files changed

Lines changed: 131 additions & 32 deletions

File tree

apps/docs/content/docs/ai/tools/mcp-server.mdx

Lines changed: 79 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,41 @@ Prisma provides an MCP server that lets AI tools manage Prisma Postgres database
1717

1818
[Tools](https://modelcontextprotocol.io/docs/concepts/tools) represent the _capabilities_ of an MCP server. Here's the list of tools exposed by the Prisma MCP server:
1919

20-
- `CreateBackupTool`: Create a new managed Prisma Postgres Backup.
21-
- `CreateConnectionStringTool`: Create a new Connection String for a Prisma Postgres database with the given id.
22-
- `CreateRecoveryTool`: Restore a Prisma Postgres Database to a new database with the given Backup id.
23-
- `DeleteConnectionStringTool`: Delete a Connection String with the given connection string id.
24-
- `DeleteDatabaseTool`: Delete a Prisma Postgres database with the given id.
25-
- `ListBackupsTool`: Fetch a list of available Prisma Postgres Backups for the given database id and environment id.
26-
- `ListConnectionStringsTool`: Fetch a list of available Prisma Postgres Database Connection Strings for the given database id and environment id.
27-
- `ListDatabasesTool`: Fetch a list of available Prisma Postgres Databases for user's workspace.
28-
- `ExecuteSqlQueryTool`: Execute a SQL query on a Prisma Postgres database with the given id.
29-
- `IntrospectSchemaTool`: Introspect the schema of a Prisma Postgres database with the given id.
20+
**Workspace and databases**
21+
22+
- `fetch_workspace_details`: Fetch the details of a Prisma Postgres workspace.
23+
- `list_prisma_postgres_databases`: Fetch a list of available Prisma Postgres databases for the user's workspace.
24+
- `create_prisma_postgres_database`: Create a new managed Prisma Postgres database.
25+
- `delete_prisma_postgres_database`: Delete a Prisma Postgres database with the given database id.
26+
27+
**Connection strings**
28+
29+
- `list_prisma_postgres_connection_strings`: Fetch a list of available connection strings for the given database id.
30+
- `create_prisma_postgres_connection_string`: Create a new connection string for a Prisma Postgres database with the given id.
31+
- `delete_prisma_postgres_connection_string`: Delete a connection string with the given connection string id.
32+
33+
**Backups and recovery**
34+
35+
- `list_prisma_postgres_backups`: Fetch a list of available backups for the given database id.
36+
- `create_prisma_postgres_backup`: Create a new managed Prisma Postgres backup.
37+
- `create_prisma_postgres_recovery`: Restore a Prisma Postgres database to a new database with the given backup id.
38+
39+
**Schema and queries**
40+
41+
- `introspect_database_schema`: Introspect the schema of a Prisma Postgres database with the given id.
42+
- `execute_sql_query`: Execute a SQL query on a Prisma Postgres database with the given id.
43+
- `execute_prisma_postgres_schema_update`: Execute a schema update on a Prisma Postgres database with the given id.
44+
45+
**Object store**
46+
47+
- `list_object_store_buckets`: List object-store buckets in the workspace, optionally filtered by project id.
48+
- `create_object_store_bucket`: Create a new object-store bucket in the given project.
49+
- `delete_object_store_bucket`: Permanently delete an object-store bucket, all objects stored in it, and all its access keys.
50+
- `create_object_store_bucket_key`: Create an S3-compatible access key for an object-store bucket.
51+
- `delete_object_store_bucket_key`: Delete an object-store bucket access key. The key stops working immediately.
52+
53+
**Documentation**
54+
3055
- `search_prisma_documentation`: Answer a natural-language question about Prisma using the official Prisma documentation, returning a cited answer with links back to the docs.
3156

3257
Once you're connected to the Prisma MCP server, you can also always prompt your AI agent to "List the Prisma tools" to get a full overview of the latest supported tools.
@@ -257,7 +282,7 @@ Claude Code is a terminal-based AI tool where you can add MCP servers using the
257282
claude mcp add --transport http prisma https://mcp.prisma.io/mcp
258283
```
259284

260-
Learn more in the [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#configure-mcp-servers).
285+
Learn more in the [Claude Code MCP docs](https://code.claude.com/docs/en/mcp).
261286

262287
### Claude Desktop only
263288

@@ -316,6 +341,49 @@ You can also add the standard MCP configuration to your `~/.gemini/settings.json
316341
}
317342
```
318343

344+
### fx
345+
346+
[fx](https://fx.sh) is a terminal coding agent by [Vercel Labs](https://github.com/vercel-labs). It reads MCP servers from a single trusted file, `~/.fx/mcp.json`, and never loads MCP configuration from a repository. Remote servers are added by editing that file directly.
347+
348+
Install fx and sign in if you haven't already:
349+
350+
```bash title="fx"
351+
curl -fsSL https://fx.sh/setup.sh | bash
352+
fx login
353+
```
354+
355+
Then add the Prisma MCP server to `~/.fx/mcp.json`. Note that fx uses an `mcp` key rather than `mcpServers`, and remote servers need `"type": "http"`:
356+
357+
```json title="~/.fx/mcp.json"
358+
{
359+
"mcp": {
360+
"Prisma": {
361+
"type": "http",
362+
"url": "https://mcp.prisma.io/mcp"
363+
}
364+
}
365+
}
366+
```
367+
368+
Start `fx` (or run `/mcp reload` in an open session), then authenticate with Prisma Console:
369+
370+
```bash title="fx session"
371+
/mcp auth Prisma --open
372+
```
373+
374+
1. Complete the Prisma Console authorization flow in your browser.
375+
1. Return to fx and run:
376+
```bash title="fx session"
377+
/mcp list
378+
```
379+
1. Confirm that the server shows `state=ready`.
380+
1. Ask fx to manage your database. For example:
381+
- "List the Prisma tools"
382+
- "Show me all databases in my workspace"
383+
1. fx checks its permission policy before each MCP tool call, so saved rules or its automatic review may let a call through without asking. If fx shows an approval prompt, select **Allow once** or **Allow this MCP tool for this session**.
384+
385+
Learn more in the [fx MCP docs](https://fx.sh/docs/capabilities/mcp).
386+
319387
## AI Safety guardrails for destructive commands
320388

321389
Prisma ORM includes built-in safety checks to prevent **accidental destructive commands** when run through AI coding assistants. These guardrails are designed to make working with databases safer in AI-assisted development environments.

apps/site/src/lib/agent-skills.ts

Lines changed: 52 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -22,47 +22,78 @@ const SKILL_DESCRIPTION =
2222
*/
2323
export const MCP_TOOLS: { name: string; description: string }[] = [
2424
{
25-
name: "CreateBackupTool",
26-
description: "Create a new managed Prisma Postgres Backup.",
25+
name: "fetch_workspace_details",
26+
description: "Fetch the details of a Prisma Postgres workspace.",
2727
},
2828
{
29-
name: "CreateConnectionStringTool",
30-
description: "Create a new Connection String for a Prisma Postgres database with the given id.",
29+
name: "list_prisma_postgres_databases",
30+
description: "Fetch a list of available Prisma Postgres databases for the user's workspace.",
3131
},
3232
{
33-
name: "CreateRecoveryTool",
34-
description: "Restore a Prisma Postgres Database to a new database with the given Backup id.",
33+
name: "create_prisma_postgres_database",
34+
description: "Create a new managed Prisma Postgres database.",
3535
},
3636
{
37-
name: "DeleteConnectionStringTool",
38-
description: "Delete a Connection String with the given connection string id.",
37+
name: "delete_prisma_postgres_database",
38+
description: "Delete a Prisma Postgres database with the given database id.",
3939
},
4040
{
41-
name: "DeleteDatabaseTool",
42-
description: "Delete a Prisma Postgres database with the given id.",
41+
name: "list_prisma_postgres_connection_strings",
42+
description: "Fetch a list of available connection strings for the given database id.",
4343
},
4444
{
45-
name: "ListBackupsTool",
46-
description:
47-
"Fetch a list of available Prisma Postgres Backups for the given database id and environment id.",
45+
name: "create_prisma_postgres_connection_string",
46+
description: "Create a new connection string for a Prisma Postgres database with the given id.",
4847
},
4948
{
50-
name: "ListConnectionStringsTool",
51-
description:
52-
"Fetch a list of available Prisma Postgres Database Connection Strings for the given database id and environment id.",
49+
name: "delete_prisma_postgres_connection_string",
50+
description: "Delete a connection string with the given connection string id.",
5351
},
5452
{
55-
name: "ListDatabasesTool",
56-
description: "Fetch a list of available Prisma Postgres Databases for user's workspace.",
53+
name: "list_prisma_postgres_backups",
54+
description: "Fetch a list of available backups for the given database id.",
5755
},
5856
{
59-
name: "ExecuteSqlQueryTool",
60-
description: "Execute a SQL query on a Prisma Postgres database with the given id.",
57+
name: "create_prisma_postgres_backup",
58+
description: "Create a new managed Prisma Postgres backup.",
6159
},
6260
{
63-
name: "IntrospectSchemaTool",
61+
name: "create_prisma_postgres_recovery",
62+
description: "Restore a Prisma Postgres database to a new database with the given backup id.",
63+
},
64+
{
65+
name: "introspect_database_schema",
6466
description: "Introspect the schema of a Prisma Postgres database with the given id.",
6567
},
68+
{
69+
name: "execute_sql_query",
70+
description: "Execute a SQL query on a Prisma Postgres database with the given id.",
71+
},
72+
{
73+
name: "execute_prisma_postgres_schema_update",
74+
description: "Execute a schema update on a Prisma Postgres database with the given id.",
75+
},
76+
{
77+
name: "list_object_store_buckets",
78+
description: "List object-store buckets in the workspace, optionally filtered by project id.",
79+
},
80+
{
81+
name: "create_object_store_bucket",
82+
description: "Create a new object-store bucket in the given project.",
83+
},
84+
{
85+
name: "delete_object_store_bucket",
86+
description:
87+
"Permanently delete an object-store bucket, all objects stored in it, and all its access keys.",
88+
},
89+
{
90+
name: "create_object_store_bucket_key",
91+
description: "Create an S3-compatible access key for an object-store bucket.",
92+
},
93+
{
94+
name: "delete_object_store_bucket_key",
95+
description: "Delete an object-store bucket access key. The key stops working immediately.",
96+
},
6697
{
6798
name: "search_prisma_documentation",
6899
description:

0 commit comments

Comments
 (0)