From 69072f03bd983fe1a148901974e4ad9cf4795cf1 Mon Sep 17 00:00:00 2001 From: Gabriel Date: Sat, 4 Jul 2026 02:30:05 -0300 Subject: [PATCH 1/2] feat(plugin): install the MCP server from PyPI The bundled .mcp.json launched the server via uvx from git+...#subdirectory refs, so every plugin install and --refresh cloned the repo and built four workspace members from source. All five packages now publish to PyPI on every tag, so uvx resolves pipefy-mcp-server and its dependency closure (pipefy, pipefy-auth, pipefy-infra) straight from the index. --prerelease allow is needed while the 0.x line ships only pre-releases; it drops once a stable release exists. Updates the MCP package README's install and `claude mcp add` snippets to match. The CLI install blocks and the root README pre-1.0 policy prose are a separate follow-up. --- .mcp.json | 8 ++------ packages/mcp/README.md | 16 ++++------------ 2 files changed, 6 insertions(+), 18 deletions(-) diff --git a/.mcp.json b/.mcp.json index f8b7f9a3..54c3f938 100644 --- a/.mcp.json +++ b/.mcp.json @@ -3,12 +3,8 @@ "pipefy": { "command": "uvx", "args": [ - "--with", - "pipefy @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk", - "--with", - "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth", - "--from", - "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/mcp", + "--prerelease", + "allow", "pipefy-mcp-server" ] } diff --git a/packages/mcp/README.md b/packages/mcp/README.md index 09acc456..97abb4dd 100644 --- a/packages/mcp/README.md +++ b/packages/mcp/README.md @@ -2,17 +2,13 @@ MCP server for Pipefy — **152 tools** for AI agents (Cursor, Claude Desktop, Claude Code, Codex, and any MCP-compatible client). Depends on [`pipefy`](../sdk/README.md) for all GraphQL and API logic. -## Install (pre-launch, v0.1 → v0.5) +## Install ```sh -uvx \ - --with "pipefy @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ - --from "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/mcp" \ - --refresh pipefy-mcp-server +uvx --prerelease allow pipefy-mcp-server ``` -The `--with pipefy` / `pipefy-auth` flags are required pre-1.0 because the workspace members are not yet on PyPI. At v1.0 this collapses to `uvx pipefy-mcp-server`. +`pipefy-mcp-server` and its workspace dependencies (`pipefy`, `pipefy-auth`, `pipefy-infra`) are published to PyPI, so `uvx` resolves the whole set from there. `--prerelease allow` is required while the toolkit ships pre-release versions (the 0.x line); once a stable release exists, `uvx pipefy-mcp-server` resolves it without the flag. For per-client wiring (Claude Code / Cursor / Claude Desktop / Codex), see [root `README.md#installation`](../../README.md#installation). @@ -44,11 +40,7 @@ Useful when you want to wire the server without editing `~/.claude.json` by hand ```bash claude mcp add --scope project pipefy \ - -- uvx \ - --with "pipefy @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ - --from "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/mcp" \ - pipefy-mcp-server + -- uvx --prerelease allow pipefy-mcp-server ``` Then (repeat for each key you need): From 6debb7f8bbca7c5b4a8b1e0dd288cdc569c8aa72 Mon Sep 17 00:00:00 2001 From: Gabriel Date: Mon, 6 Jul 2026 15:06:56 -0300 Subject: [PATCH 2/2] fix(pr-review): drop global --prerelease allow from mcp install uvx resolves pipefy-mcp-server's own pre-release without the flag since no stable release exists. The global flag also lets transitive deps take pre-releases, pulling a broken mcp 2.0.0b1 that fails on 'from mcp.server.fastmcp import FastMCP'. --- .mcp.json | 2 -- packages/mcp/README.md | 6 +++--- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/.mcp.json b/.mcp.json index 54c3f938..b5aa0809 100644 --- a/.mcp.json +++ b/.mcp.json @@ -3,8 +3,6 @@ "pipefy": { "command": "uvx", "args": [ - "--prerelease", - "allow", "pipefy-mcp-server" ] } diff --git a/packages/mcp/README.md b/packages/mcp/README.md index 97abb4dd..590529a9 100644 --- a/packages/mcp/README.md +++ b/packages/mcp/README.md @@ -5,10 +5,10 @@ MCP server for Pipefy — **152 tools** for AI agents (Cursor, Claude Desktop, C ## Install ```sh -uvx --prerelease allow pipefy-mcp-server +uvx pipefy-mcp-server ``` -`pipefy-mcp-server` and its workspace dependencies (`pipefy`, `pipefy-auth`, `pipefy-infra`) are published to PyPI, so `uvx` resolves the whole set from there. `--prerelease allow` is required while the toolkit ships pre-release versions (the 0.x line); once a stable release exists, `uvx pipefy-mcp-server` resolves it without the flag. +`pipefy-mcp-server` and its workspace dependencies (`pipefy`, `pipefy-auth`, `pipefy-infra`) are published to PyPI, so `uvx` resolves the whole set from there. While the toolkit ships only pre-release versions (the 0.x line), `uvx` resolves the latest pre-release automatically; once a stable release exists it resolves that instead. Do not pass a global `--prerelease allow`: it also lets transitive dependencies jump to their own pre-releases, which can pull a broken build. For per-client wiring (Claude Code / Cursor / Claude Desktop / Codex), see [root `README.md#installation`](../../README.md#installation). @@ -40,7 +40,7 @@ Useful when you want to wire the server without editing `~/.claude.json` by hand ```bash claude mcp add --scope project pipefy \ - -- uvx --prerelease allow pipefy-mcp-server + -- uvx pipefy-mcp-server ``` Then (repeat for each key you need):