メニュー
機能に戻る
Agent 連携

Agent から MarkNest への確かな接続

ポータブルな Skill または構造化された MCP ツールを、共通の権限スコープ付き Public V1 API で利用できます。

Skill をダウンロード セットアップを見る
Shell agent
MarkNest Skill
MCP client
MCP server
Shared contract
Public V1 API
MarkNest
Knowledge workspace
Bearer auth Scoped abilities Normalized errors

2 つの接続方法、1 つの 契約

Agent がすでに理解しているインターフェースを選べます。API の動作と権限モデルは共通です。

shell を実行できる Agent 向け

Agent Skill

自己完結型 CLI を含むポータブルな指示バンドルです。MCP runtime なしで、ワークフロー、安全規則、Public V1 API への直接アクセスを Agent に提供します。

Codex、Claude Code、OpenCode など、ローカルコマンドを実行できる Agent に最適です。

Skill をダウンロード 0.2.0 SHA-256 checksum
MCP クライアント向け

MCP サーバー

検証済み入力を持つ構造化ツールを公開するサーバーです。クライアントは利用可能な操作を検出し、MCP protocol 経由で呼び出します。

MCP をネイティブにサポートするデスクトップアシスタントや Agent host に最適です。

同じ source of truth

どちらも同じ Public V1 API client、bearer authentication、scoped abilities、正規化されたエラーを使います。

Agent が完了できる ワークフロー

Agent ごとに API を教え直すことなく、検索結果を持続する知識へ変えられます。

01

文脈付きで検索

セマンティック検索で一致する chunk を確認し、回答前にソース文書を開きます。

02

有用な成果を保存

会議の振り返り、調査メモ、session 要約を、人が確認できる下書きとして保存します。

03

知識を整理

フォルダーとタグを作成し、重複を統合して、文書を見つけやすい場所に保ちます。

04

ファイルと共有を慎重に扱う

ファイルのアップロードとダウンロード、共有状態の確認を行い、重要な変更は明示された依頼に限定します。

Agent の案内で セットアップ

短い Prompt を Agent に貼り付けるだけで、適切な接続方法を判断し、API キーを公開せずに案内できます。

Agent に MarkNest のインストールを依頼

Prompt は最新の機械可読ガイドを参照するため、手順が更新されてもページは簡潔に保たれます。

Help me install MarkNest for this agent.

Read https://marknest.net/llms.txt and follow the Agent Integration guide...
Prompt をすべて表示 
Help me install MarkNest for this agent.

Read https://marknest.net/llms.txt and follow the Agent Integration guide.
First determine whether this client supports Skills or MCP, then ask which operating system I use.
Guide me one step at a time. Keep my API key private, ask before changing configuration files, and finish with a read-only verification.
Agent ガイドを読む

API キーから最初の リクエストまで

スコープ付きキーを作成し、Agent に合う接続方法を導入して、書き込みを許可する前に実際の読み取りを試します。

  1. 1

    スコープ付き API キーを作成

    Settings で API キーを作成し、ワークフローに必要な abilities だけを付与します。

    API キー設定を開く
  2. 2

    接続方法を導入

    Skill ZIP をダウンロードして検証し、中の marknest フォルダーを Agent の skill directory に展開します。MCP の場合は npm server を client config に追加します。

  3. 3

    読み取りで確認

    まず文書一覧またはセマンティック検索を実行します。必要な場合だけ書き込み権限を追加します。

Skill bundle のインストール 0.2.0 
curl -LO https://marknest.net/downloads/marknest-skill-0.2.0.zip
curl -LO https://marknest.net/downloads/marknest-skill-0.2.0.zip.sha256
shasum -a 256 -c marknest-skill-0.2.0.zip.sha256
unzip marknest-skill-0.2.0.zip -d <agent-skill-directory>
Skill CLI の例 Skill 
export MARKNEST_API_KEY="mk_your_api_key"

node scripts/marknest.mjs search semantic \
  --query "launch notes"

node scripts/marknest.mjs documents create \
  --title "Launch recap" \
  --content "# Launch recap" \
  --status draft
MCP client config MCP 
{
  "mcpServers": {
    "marknest": {
      "command": "npx",
      "args": ["-y", "@marknest/mcp-server@0.2.0"],
      "env": {
        "MARKNEST_API_KEY": "mk_your_api_key"
      }
    }
  }
}

普段は便利に、変更には 慎重に

日常の読み取りと、知識を公開、上書き、削除する可能性がある操作を分けて扱います。

READ

安全に読み取る

断定や編集の提案をする前に、検索して文脈を確認します。

DRAFT

下書きとして保存

ワークフローが許す場合、新しい要約やメモは確認可能な下書きとして保存します。

CONFIRM

重要な操作を確認

削除、公開共有、上書きに相当する更新には、明示されたユーザーの意図が必要です。

MarkNest を Agent workflow へ

Agent 連携とスコープ付き API キーは Pro と Max プランで利用できます。

Skill をダウンロード MCP セットアップを見る