문서

MCP 서버 & API 레퍼런스

MCP 호환 에이전트를 ExecuFunction에 연결하세요. 설정 블록 하나로 워크스페이스 전 도메인의 60개 이상 도구에 타입 안전한 접근을 제공해요.

퀵스타트

5분 안에 에이전트를 연결하세요.

1. Personal Access Token 받기

ExecuFunction에 로그인하고, 설정 → API 토큰으로 이동해서 새 토큰을 만드세요. 토큰은 범위 지정 가능 — 어떤 도메인에 접근할지 선택해요.

2. MCP 클라이언트 설정하기

에이전트의 MCP 설정에 ExecuFunction을 추가하세요. Claude Code, Cursor, Windsurf, 그리고 모든 MCP 호환 클라이언트에서 작동해요.

claude_code_config.json
{
  "mcpServers": {
    "execufunction": {
      "url": "https://mcp.execufunction.com/sse",
      "headers": {
        "Authorization": "Bearer exf_pat_your_token_here"
      }
    }
  }
}

3. 연결 확인하기

에이전트에게 프로젝트나 작업을 목록으로 보여달라고 하세요. 데이터가 반환되면 연결된 거예요.

Example agent interaction
# Agent calls:
project_list()
task_list(status: "in_progress")
calendar_list_events(startDate: "2026-02-17", endDate: "2026-02-23")

# Agent now has your full operational context.

CLI Installation

The ExecuFunction CLI gives you the same 60+ tools from your terminal. Same API, same data, same permissions — just a different interface.

1. Install

Terminal
npm install -g @execufunction/cli

2. Authenticate

The CLI uses device flow authentication — it opens your browser, you approve, and a token is stored locally.

Terminal
$ exf auth login

  Your verification code: ZFMV-SBGJ

  Opening browser...
  If the browser didn't open, visit: https://execufunction.com/app/device?code=ZFMV-SBGJ

  Waiting for authorization...
  Logged in successfully!

3. Run your first command

Terminal
$ exf projects list

 NAME                STATUS    TASKS
 ExecuFunction       active    12
 Marketing Site      active    4
 Mobile App          planning  0

$ exf projects context <id>

# Full project context: tasks, signals, notes, members.

Every CLI command supports --json for machine-readable output. Pipe it into jq, feed it to scripts, or let agents parse it directly.

인증

ExecuFunction supports two authentication methods. Use device flow for interactive CLI sessions, or Personal Access Tokens for MCP clients and CI/CD.

Device Flow (CLI)

Run exf auth login. The CLI opens your browser, you sign in with Google and approve the device code. A PAT is generated and stored in ~/.config/exf/ automatically. No token to copy-paste.

Personal Access Token (MCP & API)

For MCP clients and programmatic access, create a token in Settings → API Tokens. Pass it in the Authorization header:

HTTP Header
Authorization: Bearer exf_pat_your_token_here

Tokens are scoped to specific domains (tasks-only, calendar-only, full access, etc.). For CI pipelines, set EXF_PAT as an environment variable.

Auth Commands
$ exf auth login
$ exf auth status
$ exf auth logout

토큰 범위와 사용 가능한 쓰기 작업은 워크스페이스 구성 및 요금제에 따라 달라집니다. 계정의 현재 한도는 설정 → API 토큰 및 요금제에서 확인하세요.

MCP 연결

ExecuFunction은 MCP에 Server-Sent Events (SSE) 트랜스포트를 사용해요. 엔드포인트:

MCP Endpoint
https://mcp.execufunction.com/sse

SSE 트랜스포트를 지원하는 모든 MCP 클라이언트와 호환: Claude Code, Claude Desktop, Cursor, Windsurf, Continue, 그리고 MCP SDK를 사용한 커스텀 구현.

작업

Task Domain 6 tools
MCP ToolCLIAccessDescription
task_list exf tasks list READ List tasks with filters: status (inbox, next_action, in_progress, waiting_for, completed), project, limit.
task_get exf tasks get READ Get a single task with full details: description, due date, priority, project, linked code.
task_create exf tasks create WRITE Create a task. Accepts title, description, priority (do_now, schedule, delegate, someday), project, due date.
task_update exf tasks update WRITE Update task fields: title, description, status, priority, due date, project assignment.
task_complete exf tasks complete WRITE Mark a task as completed.
task_delete exf tasks delete DELETE Permanently delete a task.
CLI Examples
$ exf tasks list --status in_progress

 TITLE                     STATUS        PRIORITY   DUE
 Ship CLI docs             in_progress   do_now     2026-02-27
 Fix device flow auth      in_progress   do_now     -

$ exf tasks create --title "Review PR #312" --priority do_now --json
{"id":"abc-123","title":"Review PR #312","status":"inbox","priority":"do_now"}

캘린더

Calendar Domain 4 tools
MCP ToolCLIAccessDescription
calendar_list_events exf calendar list READ List events in a date range. Returns title, start/end times, location, description. Supports limit.
calendar_create_event exf calendar create WRITE Create a calendar event. Requires title, startTime, endTime (ISO 8601). Optional: description, location.
calendar_update_event exf calendar update WRITE Update an existing event's title, times, description, or location.
calendar_delete_event exf calendar delete DELETE Remove an event from the calendar.
CLI Examples
$ exf calendar list --start 2026-02-24 --end 2026-02-28

 TITLE                  START              END                LOCATION
 Team standup           Feb 25 09:00       Feb 25 09:30       Zoom
 Product review         Feb 26 14:00       Feb 26 15:00       Conf Room B

$ exf calendar create --title "Ship CLI v0.3" \
    --start-time 2026-02-27T10:00:00Z --end-time 2026-02-27T10:30:00Z

프로젝트

Project Domain 5 tools
MCP ToolCLIAccessDescription
project_list exf projects list READ List projects. Filter by status (planning, active, on_hold, blocked, completed). Include archived.
project_get_context exf projects context READ Full project context: tasks, notes, members, signals. The richest single call for understanding a project.
project_create exf projects create WRITE Create a project with name, summary, status, and emoji.
project_update exf projects update WRITE Update project name, summary, status, or emoji.
project_archive exf projects archive WRITE Archive a completed or inactive project.

지식

Knowledge Domain 6 tools
MCP ToolCLIAccessDescription
note_search exf notes search READ Semantic + full-text search across notes. Filter by project or note type.
note_list exf notes list READ List notes. Filter by type (note, concept, meeting, reference, daily) and project.
note_get exf notes get READ Get full note content by ID.
note_create exf notes create WRITE Create a note with title, markdown content, type, and optional project.
note_update exf notes update WRITE Update note title, content, or type.
note_delete exf notes delete DELETE Delete a note.

Datasets

Dataset Domain 19 commands

Structured datasets support grounded summaries, grouped analysis, ranking, bucketing, time-series work, import/export, schema changes, and record mutations from the same CLI and MCP-backed platform.

CapabilityCLIAccessDescription
Browse and inspect exf datasets list, get, query, summarize READ List datasets, inspect schema, query records, and get row-count and sample summaries.
Grounded analysis exf datasets analyze, aggregate, compare READ Generate natural-language insights, grouped metrics, and side-by-side segment comparisons.
Ranking and bucketing exf datasets rank, bucket READ Sort or score records, then bucket numeric or date fields into ranges with metrics per bucket.
Time series and plots exf datasets timeseries, plot READ Compute lag, pct-change, rolling windows, drawdown, or normalize plotting payloads from derived results.
Import and export exf datasets import, export WRITE Bring CSVs in, append to existing datasets, or export filtered results back to CSV.
Create and materialize exf datasets create, materialize WRITE Create datasets directly or turn a derived result into a new scratch dataset.
Schema and records exf datasets schema, add, update-record, delete-record WRITE Modify field definitions, add rows, update rows, and delete rows with explicit commands.
Derived workflows exf datasets join, compute READ Join dataset slices and compute derived fields before materializing or plotting the result.
CLI Examples
$ exf datasets list
$ exf datasets summarize <dataset-id>
$ exf datasets analyze <dataset-id> --focus-fields BMI,Outcome
$ exf datasets aggregate <dataset-id> --group-by Outcome \
    --metrics '[{"operation":"count","as":"rows"},{"operation":"avg","field":"BMI","as":"avg_bmi"}]'
$ exf datasets compare <dataset-id> --segment-field Outcome \
    --metrics '[{"operation":"avg","field":"Glucose","as":"avg_glucose"}]'
$ exf datasets rank <dataset-id> --sorts '[{"field":"BMI","direction":"desc"}]' --limit 10
$ exf datasets bucket <dataset-id> --field Age --bucket-count 5 \
    --metrics '[{"operation":"count","as":"rows"}]'

사람

People Domain 2 tools
MCP ToolCLIAccessDescription
people_search exf people search READ Search contacts by name. Returns relationship type, company, contact info, interaction history.
exf people list READ List all contacts. CLI-only convenience wrapper.

코드베이스

Codebase Domain 12 tools

시맨틱 코드 검색을 위해 저장소를 인덱싱하세요. ExecuFunction이 코드를 심볼과 임베딩으로 파싱해서 빠르게 검색할 수 있게 해요.

MCP ToolCLIAccessDescription
codebase_list exf codebase list READ List all indexed repositories.
codebase_register exf codebase register WRITE Register a repository for indexing. Set root path, name, include/exclude patterns.
codebase_status exf codebase status READ Check indexing status for a repository.
codebase_index exf codebase index WRITE Full index: scan and upload all files matching patterns.
codebase_index_incremental WRITE Git-aware incremental index. Only processes changed files since last index. MCP only.
codebase_search exf codebase search READ Semantic code search. Filter by repository, language, symbol type (function, class, interface, type, export, impl).
codebase_snapshot_status exf codebase snapshot READ Get the latest index snapshot for a repository, optionally filtered by branch or materialized for download.
codebase_delete exf codebase delete DELETE Delete a repository and all indexed code data.
code_who_knows exf code who-knows READ Find developers with expertise in a code area. Based on git history and contribution patterns.
code_compute_expertise exf code expertise WRITE Refresh the expertise index for a repository.
code_history exf code history READ Get commit history. Filter by file path.
git_blame_symbol exf code blame READ Git blame for a file or line range. Shows who last modified each line.
Related Code CLI
$ exf code history <repo-id> --path src/auth/service.ts
$ exf code blame src/auth/service.ts --root .
$ exf code expertise <repo-id>
$ exf code who-knows <repo-id> src/auth
$ exf code link <task-id> --repo <repo-id> --file src/auth/service.ts

코드 메모리

Code Memory Domain 4 tools

코드베이스에 대한 사실을 저장하고 검색하세요. 아키텍처 결정, 컨벤션, 주의사항, 소유권 — 세션을 넘어 유지되는 영구적 지식.

MCP ToolCLIAccessDescription
code_memory_store exf code memory store WRITE Store a fact. Categories: architecture, integration, convention, entrypoint, gotcha, ownership. Optional: file path, repository.
code_memory_search exf code memory search READ Semantic search over stored code facts. Filter by category or repository.
code_memory_list exf code memory list READ List all stored code memories. Filter by repository.
code_memory_delete exf code memory delete DELETE Delete a stored code memory by ID.

문서

Document Domain 1 command
MCP ToolCLIAccessDescription
upload_document exf documents upload WRITE Upload a PDF, Markdown, or text file into Knowledge. Set by file path or inline content. Auto-detects type.

Vault

Vault Domain 5 tools

Encrypted secret storage. Store API keys, credentials, OAuth tokens, SSH keys, and sensitive notes. Values are encrypted at rest and audit-logged on read.

MCP ToolCLIAccessDescription
vault_create exf vault create WRITE Store a new encrypted secret. Types: env_var, credential, oauth_token, ssh_key, certificate, note.
vault_list exf vault list READ List vault entries (metadata only — never decrypted values). Filter by type or category.
vault_search exf vault search READ Search vault entries by name, slug, or description. Returns metadata only.
vault_read exf vault read READ Decrypt and read a vault secret. Audit-logged. Only available to trusted clients.
vault_update exf vault update WRITE Update vault entry metadata: name, tags, category, description.
CLI Examples
$ exf vault create --name "Stripe API Key" --json
# Interactive prompt for sensitive payload values

$ exf vault list

 NAME                TYPE         CATEGORY     CREATED
 Stripe API Key      env_var      payments     2026-02-25
 GitHub PAT          credential   devtools     2026-02-20

$ exf vault read --entry-id <id>
# Decrypts and displays. Audit-logged.

Workflows

Cross-domain recipes that combine multiple tools. These patterns work identically via MCP or CLI.

Link Code to Tasks

Connect implementation work to the task that motivated it. Agents and teammates can trace why code changed.

MCP
task_create(title: "Implement device flow auth", priority: "do_now")
# ... implement the feature ...
task_link_code(taskId: "abc-123", repositoryId: "repo-456",
  commitSha: "5cf5f22", filePath: "src/services/deviceAuthService.ts",
  notes: "Fixed verification_uri to use /app/device")
task_complete(taskId: "abc-123")
CLI
$ exf tasks create --title "Implement device flow auth" --priority do_now
$ exf code link abc-123 --repo repo-456 \
    --commit 5cf5f22 --file src/services/deviceAuthService.ts
$ exf tasks complete abc-123

Project Onboarding

New to a project? Pull the full context in three commands.

CLI
# 1. Get the big picture
$ exf projects context <id>

# 2. See what's in flight
$ exf tasks list --project <id> --status in_progress

# 3. Check code conventions
$ exf code memory search "architecture and conventions"

End-of-Day Review

Summarize what happened today. Works great as an agent prompt or a manual check.

MCP (agent prompt)
# Agent calls:
calendar_list_events(startDate: "2026-02-26", endDate: "2026-02-26")
task_list(status: "completed", limit: 20)
task_list(status: "in_progress")

# Agent now has: today's meetings, completed tasks, and remaining work.
# It can draft a standup summary, update project status, or flag blockers.
CLI
$ exf calendar list --start 2026-02-26 --end 2026-02-26
$ exf tasks list --status completed --limit 20 --json | jq '.[] | .title'
$ exf tasks list --status in_progress

Store a Debug Discovery

Found a gotcha? Store it so your future self (or your agent) doesn't rediscover it the hard way.

CLI
$ exf code memory store \
    --fact "Device flow verification_uri must use /app/device (SPA path), not /device (marketing homepage)" \
    --category gotcha \
    --file src/services/deviceAuthService.ts

크레딧 & 결제

모든 워크스페이스는 채팅, 분석 및 도구 지원 작업에 크레딧 기반 청구를 사용합니다. 읽기 작업은 일반적으로 무거운 추론이나 다단계 분석보다 저렴합니다.

모든 신규 사용자에게는 가입 시 200 크레딧이 제공되며, 이 200 크레딧은 매월 갱신됩니다. 무료 요금제에는 빠른 속도의 모델과 핵심 컨텍스트 관리 도구 시스템이 포함됩니다.

모델별 크레딧 비용 및 요금제 세부 정보는 execuTerm Pricing을(를) 참조하세요.

멱등성

쓰기 작업(task_create, note_create, calendar_create_event 등)은 선택적 idempotencyKey 파라미터를 받아요. 같은 키로 요청을 재시도하면 ExecuFunction이 중복 생성 대신 원래 결과를 반환해요.

Idempotent task creation
task_create(
  title: "Review PR #247",
  priority: "do_now",
  idempotencyKey: "agent-run-42-task-pr247"
)

# Safe to retry. Same key = same result.

권한

토큰은 도메인별로 범위가 지정돼요. 캘린더 전용 토큰은 작업이나 사람을 읽을 수 없어요. 에이전트에 필요한 최소 접근 권한으로 토큰 범위를 지정하세요.

사용 가능한 범위:

  • tasks — Task CRUD and completion
  • calendar — Event listing and creation
  • projects — Project management and context
  • knowledge — Notes, search, document upload
  • people — Contact search
  • code — Codebase indexing, search, memory, blame
  • * — Full access (all domains)

사용 가능한 쓰기 작업은 토큰 범위와 현재 워크스페이스 요금제에 따라 달라집니다. 프로덕션 환경에서 쓰기 작업을 수행하기 전에 발급한 토큰과 현재 요금제 페이지를 확인하세요.

에이전트에게 워크스페이스를 주세요.

API 키 받기 왜 ExecuFunction인가요? →