Proporciona a los agentes de IA acceso temporal y aprobado por el propietario a los flujos de Node-RED a través de MCP, REST o enlaces GET.
También conocido como com55/node-red-ai-access, @com55/node-red-ai-access
- Stars
- 1
- Herramientas
- —
- Descargas, 30 días
- 2297
- Última versión
- —
- Último commit
- 11 nov 2026
- Licencia
- MIT
¿Qué es node-red-ai-access MCP?
node-red-ai-access es un MCP server. Proporciona a los agentes de IA acceso temporal y aprobado por el propietario a los flujos de Node-RED a través de MCP, REST o enlaces GET.
Resumen generado a partir del README del proyecto
Acerca del MCP server de node-red-ai-access
La función principal de este plugin para Node-RED 4.x+ es otorgar a los agentes de IA un acceso controlado y temporal a los flujos de Node-RED. Permite a los desarrolladores proporcionar canales de interacción específicos a los clientes de IA mediante un endpoint MCP JSON-RPC, una API REST con versiones o enlaces HTTP GET simples. Esta configuración garantiza que cualquier cambio sugerido por una IA se trate como una propuesta en lugar de una mutación inmediata, requiriendo la aprobación humana a través de un panel de administración ubicado en la ruta /ai-access.
Los usuarios gestionan estas interacciones mediante un modelo mental inspirado en Git, donde las sugerencias de la IA actúan como pull requests. Los administradores pueden revisar diffs legibles de los nodos y sus propiedades, aprobarlos para implementar los cambios o rechazarlos para mantener el flujo en vivo intacto. El sistema admite diferentes tipos de tokens para diversas capacidades de los clientes, incluyendo enlaces especializados para las IA de chat que solo admiten peticiones GET. La seguridad se mantiene mediante configuraciones de tiempo de vida (TTL) configurables, con enlaces GET limitados a 24 horas y enlaces MCP o REST con una duración de hasta 30 días.
Qué puedes hacer con él
- 1Revisión de cambios de flujo realizados por IAUn desarrollador puede inspeccionar un diff legible de las propiedades de los nodos antes de decidir si fusiona la sugerencia de una IA en el entorno de producción.
- 2Conexión de clientes de IA basados en chatPuedes proporcionar un enlace simple a una IA de chat que solo admita peticiones HTTP GET para permitirle interactuar con tus flujos.
- 3Gestión de acceso para agentes automatizadosLos desarrolladores pueden emitir tokens específicos para clientes MCP o REST para habilitar una comunicación estructurada mediante JSON-RPC.
- 4Auditoría de actividad de agentesLos administradores pueden rastrear todas las interacciones y cambios realizados por los agentes de IA a través de un log dedicado.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar node-red-ai-access MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar node-red-ai-access MCP en Claude Code
$ claude mcp add node-red-ai-access -- npx -y @com55/node-red-ai-accessInstalar node-red-ai-access MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"node-red-ai-access": {
"command": "npx",
"args": [
"-y",
"@com55/node-red-ai-access"
]
}
}
}Instalar node-red-ai-access MCP en VS Code
.vscode/mcp.json
{
"servers": {
"node-red-ai-access": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@com55/node-red-ai-access"
]
}
}
}Instalar node-red-ai-access MCP en VS Code CLI
$ code --add-mcp '{"name":"node-red-ai-access","type":"stdio","command":"npx","args":["-y","@com55/node-red-ai-access"]}'Instalar node-red-ai-access MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"node-red-ai-access": {
"command": "npx",
"args": [
"-y",
"@com55/node-red-ai-access"
]
}
}
}Instalar node-red-ai-access MCP en Codex
$ codex mcp add node-red-ai-access -- npx -y @com55/node-red-ai-accessInstalar node-red-ai-access MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.node-red-ai-access] command = "npx" args = ["-y", "@com55/node-red-ai-access"]
Instalar node-red-ai-access MCP en Gemini CLI
$ gemini mcp add -s user node-red-ai-access npx -- -y @com55/node-red-ai-accessInstalar node-red-ai-access MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"node-red-ai-access": {
"command": "npx",
"args": [
"-y",
"@com55/node-red-ai-access"
]
}
}
}Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasNo verificado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
README
Ver en GitHubNode-RED AI Access
Temporary, owner-approved Node-RED access for AI clients. Ships as a Node-RED 4.x+ plugin with:
- an admin dashboard at
/ai-access(browserGET /mcpredirects there) - a versioned REST API under
/mcp/api/v1 - an MCP JSON-RPC endpoint at
/mcp/rpc(Streamable HTTP) over the same services
Git mental model: a proposal is like a pull request. Human approve = merge;
reject = close; withdraw = the author closes their own PR. Revision changes
auto-rebase open proposals. A conflict blocks approval until resolved. Open
proposals expire after a configurable TTL (default 7 days). Every access link
can see all proposals (mine: true|false).
Derived from ziv-daniel/node-red-mcp.
Install (Node-RED plugin)
Requirements: Node-RED 4.x or newer, Node.js 20.19+ (tested: Node-RED 4.1 on
Node 20/22, Node-RED 5.0 on Node 22/24), and adminAuth enabled
(recommended). Without adminAuth, AI features stay off unless you opt in; see
Configuration.
-
In the Node-RED Palette Manager, choose Menu → Manage palette → Install, then search for
@com55/node-red-ai-access. -
Or install with npm in your Node-RED user directory:
cd ~/.node-red npm install @com55/node-red-ai-accessStable releases use npm. From 0.2.0-beta.12 onward, pre-releases are
.tgzfiles available only as GitHub Release assets, not on npm. Pick a version from GitHub Releases and use its exact install command from the release notes. For example, replaceX.Y.Zwith the full version, including its pre-release suffix (/datais typical for Docker; otherwise use~/.node-red):cd /data && npm i https://github.com/com55/node-red-ai-access/releases/download/vX.Y.Z/com55-node-red-ai-access-X.Y.Z.tgz -
Restart Node-RED.
Quick start
- Log in to the editor, then open
/ai-accesson the admin root (for examplehttp://localhost:1880/ai-access, or{httpAdminRoot}/ai-accesswhenhttpAdminRootis set), or click Open AI Access dashboard in the editor sidebar. Opening/mcpin a browser redirects to the dashboard (MCP clients keep using/mcp). - Create an access token on the dashboard's Access tokens tab (admin
*only). Choose the token kind for your client. - Either connect an MCP client or give an AI the full GET link. Changes become pending proposals for human review and approval.
Choose a channel
Prefer MCP or REST when your client can send custom headers and JSON bodies. Use
a GET link for chat AIs that can only HTTP GET. Each token works on one surface;
choose mcp, rest, or get_link to match the client.
Copy the token when it is created: it is shown only once. Access links are in memory and become invalid after a Node-RED restart. The default TTL is 4 hours; GET links are capped at 24 hours, REST / MCP links at 30 days.
Review changes
The AI reads flows and submits proposals. Open Proposals on the dashboard to review the readable node/property diff against the live flow, then approve or reject. Approval deploys the changes; rejection never mutates flows.
Users with read (including guest, if configured) have a read-only view.
Creating or revoking access links and approving or rejecting proposals require
* permission. The Audit log tab records activity for review.
See the AI quickstart for GET links and Bearer REST / MCP examples, and the dashboard guide for sign-in, tabs, and permissions.
Docs
| Document | Description |
|---|---|
| Channel index | GET link / REST / MCP overview |
| Dashboard | Sign-in, tabs, and permissions |
| Configuration | Settings, proxy URLs, CORS, redaction, and storage |
| MCP OAuth | Endpoints, consent, token lifetimes, and public exposure |
| REST API | Routes, MCP JSON-RPC, proposals, and runtime adapters |
| AI quickstart | GET links, Bearer REST / MCP, and examples |
| MCP client setup | Claude Desktop, Cursor, VS Code, and CLI |
| MCP tools reference | Generated from live tools/list |
| Error codes | Code, HTTP status, meaning, hint, and channels |
| Development | Build, test, quality, and generated references |
| Releasing | Versioning, release assets, and npm publishing |
| OpenAPI 3.1 | Also served at GET /mcp/api/v1/openapi.yaml and GET /mcp/api/v1/openapi.json |
Development
Build and test with yarn; see Development for commands and generated reference checks.
License
MIT — see LICENSE.
Preguntas sobre node-red-ai-access MCP
¿Cómo agrego node-red-ai-access MCP a Claude Code?
Ejecuta claude mcp add node-red-ai-access -- npx -y @com55/node-red-ai-access en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego node-red-ai-access MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cuáles son las diferentes formas en que un cliente de IA puede conectarse?
Los clientes pueden conectarse usando MCP, una API REST con versiones o un enlace GET simple para las IA de chat que solo admiten HTTP GET.
¿Cómo se aplican los cambios realizados por la IA en mis flujos?
La IA envía propuestas que aparecen en el panel de administración; un humano debe revisar el diff y aprobar la propuesta para implementar los cambios.
¿Cuánto duran los enlaces de acceso?
El TTL predeterminado es de 4 horas, pero los enlaces GET están limitados a 24 horas, mientras que los enlaces REST y MCP pueden durar hasta 30 días.