World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Annotate screenshots in the Snipaya macOS app: arrows, text, redaction, crop, export
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Snipaya. Sigue https://mcp.popnx.com/i/krzysztofsurdy-snipaya-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Snipaya (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Snipaya para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "snipaya": { "command": "npx", "args": [ "-y", "snipaya-mcp" ], "env": { "SNIPAYA_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SNIPAYA_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Snipaya aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
SettingsDeveloperEdit Config
{
"mcpServers": {
"snipaya": {
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Snipaya y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Snipaya o muestra una herramienta de Snipaya en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH Establezca en 1 para no abrir nunca Snipaya cuando no está en ejecución Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Snipaya
Snipaya se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Snipaya
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Snipaya (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Snipaya para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user snipaya --env SNIPAYA_MCP_TOKEN=your-value -- npx -y snipaya-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SNIPAYA_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Snipaya aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user snipaya --env SNIPAYA_MCP_TOKEN=your-value -- npx -y snipaya-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Snipaya en la lista como conectado
Usa Snipaya y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Snipaya o muestra una herramienta de Snipaya en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH Establezca en 1 para no abrir nunca Snipaya cuando no está en ejecución Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Snipaya (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Snipaya para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "snipaya": { "command": "npx", "args": [ "-y", "snipaya-mcp" ], "env": { "SNIPAYA_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SNIPAYA_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Snipaya aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Snipaya, SNIPAYA_MCP_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Snipaya y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Snipaya o muestra una herramienta de Snipaya en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH Establezca en 1 para no abrir nunca Snipaya cuando no está en ejecución Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Snipaya (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Snipaya para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "snipaya": { "type": "stdio", "command": "npx", "args": [ "-y", "snipaya-mcp" ], "env": { "SNIPAYA_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En SNIPAYA_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Snipaya aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Snipaya, SNIPAYA_MCP_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Snipaya y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Snipaya o muestra una herramienta de Snipaya en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
SNIPAYA_MCP_URL MCP URL from Snipaya > Settings > AI Assistants. Uses the port Snipaya saved when unsetSNIPAYA_MCP_NO_LAUNCH Establezca en 1 para no abrir nunca Snipaya cuando no está en ejecución Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user snipaya --env SNIPAYA_MCP_TOKEN=your-value -- npx -y snipaya-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"snipaya": {
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"snipaya": {
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"snipaya": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"snipaya-mcp"
],
"env": {
"SNIPAYA_MCP_TOKEN": "your-value"
}
}
}
}SNIPAYA_MCP_TOKEN secreto obligatorio envSNIPAYA_MCP_URL envSNIPAYA_MCP_NO_LAUNCH envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: snipaya-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub krzysztofsurdy, dueña del repo
Último cambio de código: hace 15 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para snipaya-mcp@1.2.2
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/krzysztofsurdy-snipaya-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: SNIPAYA_MCP_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 15 días, y la última versión (1.2.2) llegó al registro hace 27 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| Este Snipaya | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
snipaya-mcp
Connect any MCP client that speaks stdio to Snipaya, the image and screenshot annotator for macOS. Your assistant can read the canvas, add arrows, text, shapes and callouts, redact sensitive data, crop, and export, while you watch the result in Snipaya.
Snipaya has an MCP server built in, served over Streamable HTTP on 127.0.0.1. snipaya-mcp is a thin bridge for clients that only start local stdio servers: it forwards every MCP message between the client and Snipaya, unchanged.
Tools and prompts are listed even before Snipaya is open. Until Snipaya answers, the bridge lists them from a built-in catalog, and a tool call returns a message that says what to do.
Listed on the MCP Registry as io.github.krzysztofsurdy/snipaya-mcp, on Glama and in TensorBlock awesome-mcp-servers.
npx setup).The server is off by default.
That is all the bridge needs. It reads the access token and port from the settings Snipaya saves on this Mac, so you do not have to copy them.
npx -y snipaya-mcp
If Snipaya is not running but Allow AI assistants is on, the bridge opens Snipaya in the background and waits up to 10 seconds for its server.
To override what Snipaya saved, set these variables or flags. Flags win over variables, and variables win over the saved settings.
| Variable | Flag | Default | |
|---|---|---|---|
SNIPAYA_MCP_TOKEN | --token | Token Snipaya saved | Access token from Settings > AI Assistants. |
SNIPAYA_MCP_URL | --url | http://127.0.0.1: /mcp, else http://127.0.0.1:47321/mcp | Server URL from Snipaya. Only 127.0.0.1 and localhost are accepted. |
SNIPAYA_MCP_NO_LAUNCH | Set to 1 to never open Snipaya. While Snipaya is closed, tool calls then return Cannot reach Snipaya. |
Prefer the environment variable over --token: command-line flags are visible to other processes on the Mac.
For clients configured with an mcpServers JSON file:
{
"mcpServers": { "snipaya": { "command": "npx", "args": ["-y", "snipaya-mcp"], "env": { "npm_config_registry": "https://registry.npmjs.org/" } } } }
For a custom setup, pass the values in env instead:
{
"mcpServers": { "snipaya": { "command": "npx", "args": ["-y", "snipaya-mcp"], "env": { "npm_config_registry": "https://registry.npmjs.org/", "SNIPAYA_MCP_TOKEN": " ", "SNIPAYA_MCP_URL": " " } } } }
If your client supports Streamable HTTP servers directly, you do not need this bridge: use Copy MCP config in Snipaya instead.
snipaya-mcp- .mcpb from the latest release.127.0.0.1 and accepts only loopback Host headers and requests without an Origin header, so websites in your browser cannot reach it. The bridge refuses any URL whose host is not 127.0.0.1 or localhost, and never sends an Origin header.Authorization: Bearer . Snipaya generates the token, and Regenerate in Settings revokes the old one. The bridge never writes the token to its logs.SNIPAYA_MCP_TOKEN, the bridge reads the token and port from ~/Library/Application Support/Snipaya/mcp.json, which Snipaya writes readable only by your macOS user. The bridge never writes to it.open -g -b dev.snipaya.app (no shell) and retries. It does this at start, and again for a tool call while Snipaya is not reachable. Any other failure, such as a rejected token, never opens the app. SNIPAYA_MCP_NO_LAUNCH=1 turns this off.The tools come from the Snipaya version you have installed. Until Snipaya answers, the bridge lists the tools of Snipaya 1.3.3 from its catalog, and once Snipaya answers, the list of your installed version applies. Snipaya 1.3 provides:
| Tool | Title |
|---|---|
snipaya_get_canvas | Get canvas |
snipaya_render | Render canvas |
snipaya_add_image | Add image |
snipaya_add_arrow | Add arrow or line |
snipaya_add_shape | Add shape |
snipaya_add_text | Add text |
snipaya_add_step | Add step number |
snipaya_add_emoji | Add emoji |
snipaya_add_freehand | Add freehand stroke |
snipaya_add_magnifier | Add magnifier |
snipaya_add_callout | Add callout |
snipaya_add_spotlight | Add spotlight |
snipaya_add_measure | Add measurement |
snipaya_pick_color | Pick color |
snipaya_read_text | Read text |
snipaya_redact | Redact sensitive data |
snipaya_update_items | Update elements |
snipaya_delete_items | Delete elements |
snipaya_select | Select elements |
snipaya_arrange | Arrange images |
snipaya_set_crop | Set crop |
snipaya_undo | Undo |
snipaya_redo | Redo |
snipaya_tabs | Manage tabs |
snipaya_export | Export image |
snipaya_list_destinations | List export destinations |
snipaya_export_to | Export to destination |
snipaya_save_project | Save project |
| Prompt | Title | Optional argument |
|---|---|---|
explain_bug | Explain a bug in a screenshot | issue |
redact_before_sharing | Redact secrets before sharing | also_hide |
finish_screenshot | Make a screenshot look finished | background |
copy_text | Copy text out of an image | area |
make_walkthrough | Turn screenshots into a walkthrough | topic |
compare_before_after | Compare before and after | change |
The bridge writes the problem to stderr (never stdout, which carries the protocol). While Snipaya is not reachable, it still lists the tools, and returns the same text as the result of each tool call. When Snipaya starts answering, for example after you open it or accept the license agreement, the next tool call reaches it without a restart.
| Message | Fix |
|---|---|
Snipaya's settings were not found | Install Snipaya, open it once and turn on Allow AI assistants. Or set SNIPAYA_MCP_TOKEN. |
Snipaya is a macOS app | The bridge runs on another system. It lists the tools, but they work only with Snipaya on a Mac. |
Snipaya's MCP server is off | Turn on Allow AI assistants in Settings > AI Assistants. |
Snipaya's settings ... cannot be read or hold no valid token | Open Snipaya, which rewrites its settings, then check Allow AI assistants. Or set SNIPAYA_MCP_TOKEN. |
Cannot open Snipaya | Snipaya is not installed in a place macOS can find. Install it from snipaya.app or open it yourself. |
Opened Snipaya, but its MCP server starts only after you accept the license agreement | Snipaya 1.1 and newer start the MCP server only after you accept the license agreement. Accept it in the Snipaya window, then call the tool again. |
Opened Snipaya, but its MCP server did not answer | Open Settings > AI Assistants and fix the error shown under the status. |
Cannot reach Snipaya at ... | Open Snipaya and turn on Allow AI assistants. If the message mentions the license agreement, accept it in Snipaya first. If the status shows an error, fix that first. Check that the URL matches Server URL. |
Snipaya rejected the token | The token changed, for example after Regenerate. Remove SNIPAYA_MCP_TOKEN to use the saved token, or copy the current one. |
Snipaya ended the session | Snipaya restarted or the token changed. Restart the snipaya server in your client. |
Refusing | The URL must point to 127.0.0.1 or localhost. Copy Server URL from Snipaya. |
CONNECTION_CLOSED or Failed to connect, with npm error 404 ... is not in this registry in the MCP log | The bridge never started: a project .npmrc points npm at a private registry, and MCP clients start the server in the project folder. Set npm_config_registry to https://registry.npmjs.org/ for the snipaya server, in env as in the JSON config above. In Claude Code, add the server once for every project with claude mcp add --scope user snipaya -e npm_config_registry=https://registry.npmjs.org/ -- npx -y snipaya-mcp. Claude Code keeps MCP server logs in ~/Library/Caches/claude-cli-nodejs/ /mcp-logs-snipaya/. |
Run npx -y snipaya-mcp --help to see the options.
npm ci
npm run lint npm run typecheck npm test # builds, then runs the bridge over stdio against a local test server npm run pack:mcpb # builds snipaya-mcp- .mcpb with the official mcpb CLI
catalog.json holds the tools, prompts and instructions the bridge serves while Snipaya is not reachable, and manifest.json lists the same tools and prompts. Regenerate both from a checkout of the Snipaya app (default ../snipaya) with Node 22.6 or newer, and commit the result:
npm run sync:catalog -- ../snipaya
Without a token or URL, the bridge reads the settings of the installed Snipaya in ~/Library/Application Support/Snipaya. Development builds of Snipaya keep their settings in their own Snipaya Dev profile folder, so to bridge to one, set SNIPAYA_MCP_TOKEN and SNIPAYA_MCP_URL to the values shown in