vibeflow-n8n/docs/install.md

Install and Setup

This document gives practical setup guidance for each supported client. Keep credentials and secret values out of the repository whenever possible.

Shared prerequisites

Before setting up a client, make sure you have:

• a working n8n instance
• access to its MCP server or MCP-enabled endpoint
• a client that supports MCP
• a place to store client-level config and auth safely

Recommended setup pattern

1. Configure the n8n MCP server in the client.
2. Keep this repository in the working directory.
3. Reference templates/system-prompt.md and docs/conversation-contract.md.
4. Ask the agent to emit a normalized plan before it builds.
5. Test with one recipe.

Codex CLI

See clients/codex/config-snippets.md.

Claude Code

See clients/claude-code/config-snippets.md.

OpenCode

See clients/opencode/config-snippets.md.

OpenClaude and forks

See clients/openclaude/config-snippets.md.

Secrets and auth

Prefer one of these patterns:

• client-managed OAuth flow
• environment variables referenced by the client config
• local machine secret manager

Avoid putting raw secrets in:

• repository-tracked JSON files
• prompt templates
• examples intended for public publication