veyra-contacts

AI 에이전트를 위한 연락처 관리자 MCP 도구입니다. 이름, 이메일, 전화번호, 회사 정보를 저장하고 조회할 수 있습니다. 연락처 데이터는 비즈니스에 매우 중요하므로 모든 쓰기 작업은 Class B이며 Veyra 커밋 모드 인증이 필요합니다.

개요

veyra-contacts는 AI 에이전트에게 SQLite 기반의 영구적인 연락처 데이터베이스를 제공합니다. 읽기는 무료입니다. 모든 변경 작업(생성, 업데이트, 삭제)은 연락처 데이터가 비즈니스에 중요하며 실수로 인한 쓰기로부터 보호되어야 하므로 Class B(€0.02)로 분류됩니다.

설치

npm install
npm run build

데이터는 ~/.veyra-contacts/data.db에 저장되며, 처음 실행 시 자동으로 생성됩니다.

MCP 설정 (Claude Desktop)

{
  "mcpServers": {
    "veyra-contacts": {
      "command": "node",
      "args": ["/absolute/path/to/veyra-contacts/dist/index.js"]
    }
  }
}

도구

도구	입력	클래스	가격
`list_contacts`	`{ tag?, company? }`	—	무료
`get_contact`	`{ id }`	—	무료
`search_contacts`	`{ query }`	—	무료
`create_contact`	`{ name, email?, phone?, company?, tags?, veyra_token? }`	B	€0.02
`update_contact`	`{ id, name?, email?, veyra_token? }`	B	€0.02
`delete_contact`	`{ id, veyra_token? }`	B	€0.02

연락처 데이터는 비즈니스에 중요하므로 모든 쓰기 작업은 Class B입니다.

예시

읽기 (토큰 불필요)

// List all contacts
{ "tool": "list_contacts", "arguments": {} }

// Filter by company
{ "tool": "list_contacts", "arguments": { "company": "Acme Corp" } }

// Search across name, email, company, tags
{ "tool": "search_contacts", "arguments": { "query": "alice" } }

// Get a specific contact
{ "tool": "get_contact", "arguments": { "id": "1712345678-abc1234" } }

쓰기 (Veyra 토큰 필요 — Class B)

// Create a contact
{
  "tool": "create_contact",
  "arguments": {
    "name": "Alice Müller",
    "email": "alice@example.com",
    "phone": "+49 123 456789",
    "company": "Acme Corp",
    "tags": "customer,vip",
    "veyra_token": "vt_..."
  }
}

// Update a contact
{
  "tool": "update_contact",
  "arguments": {
    "id": "1712345678-abc1234",
    "email": "alice.new@example.com",
    "veyra_token": "vt_..."
  }
}

// Delete a contact
{
  "tool": "delete_contact",
  "arguments": { "id": "1712345678-abc1234", "veyra_token": "vt_..." }
}

토큰 누락 시 오류 응답

{
  "error": "VeyraCommitRequired",
  "message": "Write operations require Veyra commit mode.",
  "currentMode": "open",
  "requiredMode": "commit",
  "authorize_endpoint": "https://api.veyra.to/v1/authorize-action",
  "docs_url": "https://veyra.to"
}

Veyra 작동 방식

Veyra는 AI 에이전트를 위한 커밋 모드 인증 계층입니다. 에이전트가 쓰기를 시도할 때:

에이전트가 veyra_token 없이 도구를 호출하면 → authorize_endpoint가 포함된 VeyraCommitRequired를 받습니다.
에이전트/사용자가 인증 엔드포인트를 호출하여 토큰을 획득합니다.
에이전트가 veyra_token을 설정하여 다시 시도합니다.
veyra-contacts는 작업을 실행하기 전에 @veyrahq/sdk-node를 통해 토큰을 검증합니다.

전체 문서는 veyra.to를 참조하세요.

라이선스

MIT

veyra-contacts

veyra-contacts

개요

설치

MCP 설정 (Claude Desktop)

도구

예시

읽기 (토큰 불필요)

쓰기 (Veyra 토큰 필요 — Class B)

토큰 누락 시 오류 응답

Veyra 작동 방식

라이선스

Resources

Latest Blog Posts

MCP directory API