Setup Guide

Configure CLI and Remote MCP for your AI agents.

Prerequisites

VESS account created
Project created
Node.js 22+
Claude Code installed
macOS (recommended for beta)

Beta: Limited Platform Support

The CLI (agentd) currently supports macOS and Claude Code only. Windows, Linux, and other AI coding agents (e.g. Codex) are not yet supported. Support for additional platforms is planned for future releases.

Setup Steps

1

Install CLI

Install the VESS CLI globally via npm.

npm install -g @vess-id/vess
2

Initialize Device

Generate a DID key pair for your device and link it to your VESS account. A browser window will open for verification.

vess init
3

Restart Claude Code

Restart Claude Code to load the MCP server.

Environment Protection (Optional)

Securely manage sensitive .env values via OS Keychain.

vess env import .env --profile myapp

Troubleshooting

"Not initialized" → Run vess init
"No projects found" → Create a project in dashboard, then run vess project sync
Session expired → Run vess login
Claude Code doesn't see VESS → Run vess init again, restart Claude Code
Start fresh → Run vess reset
🎉

セットアップ完了!

AIエージェントに話しかけて、連携したサービスを使ってみましょう。

Slack を連携した方:

"Slack の #your-test-channel に「Hello from AI!」と送って"

Slack を連携した方:

"#random の先週の投稿をサマリーして"

JIRA を連携した方:

"JIRAの私の担当チケットの一覧を見せて"

ダッシュボードを開く