Knotie AI Pro MCP Server

Name: Knotie AI Pro MCP Server
Author: avijeett007

ローカル

github.com/avijeett007AI・エージェント273 週間前に更新

リポジトリ

Knotie AI Pro MCP Server について

Knotie AI Pro MCP Serverは、Knotie AI ProのパートナーがMCPクライアントから顧客アカウントやAI音声エージェントを管理するためのサーバーです。複数のプラットフォームのエージェント連携に対応し、APIキーはローカル設定に保存します。

主な機能

01顧客作成とポータルアクセス管理
02顧客パスワードのリセット
03顧客のAIエージェント連携と設定
04Retell、VAPI、ElevenLabs、GoHighLevelに対応
05APIキーをローカル設定に保存

活用シーン

01顧客アカウントの作成とポータル有効化
02音声エージェントと顧客の連携
03顧客のエージェント連携の更新や解除
04APIのヘルス状態の確認

MCP 対応

MCPクライアントに顧客管理、エージェント管理、システムのヘルス確認ツールを提供し、Knotie AI ProのAPI認証情報を使ってプラットフォームと連携します。

#knotie-ai #mcp #ai-agent-management

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "knotie-ai": {
      "command": "npx",
      "args": [
        "-y",
        "knotie-ai-mcp"
      ]
    }
  }
}

起動コマンドnpx -y knotie-ai-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmknotie-ai-mcpstdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Knotie AI Pro MCP サーバー

Claude Desktop などの AI エージェントが Knotie AI Pro プラットフォームと連携し、顧客および音声 AI エージェントの管理を自動化できるようにする、Model Context Protocol（MCP）サーバーです。

🚀 機能

顧客管理：顧客の作成、ポータルアクセスの有効化、パスワードのリセット
エージェント管理：AI エージェントと顧客の紐付け、設定の更新、利益率の管理
マルチプラットフォーム対応：Retell、VAPI、ElevenLabs、GoHighLevel に対応
安全なローカル設定：API キーはローカルに保存され、第三者に送信されません
Claude Desktop との連携：Claude Desktop やその他の MCP クライアントとシームレスに連携

📋 前提条件

Node.js 18+ がインストールされていること
API アクセス権のある Knotie AI Pro パートナーアカウント
Claude Desktop またはその他の MCP 対応クライアント

🚀 クイックスタート

NPM ユーザー向け（推奨）

# 1. Install globally
npm install -g knotie-ai-mcp

# 2. Run interactive setup
npm run setup
# OR manually create config:
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"[email protected]","baseUrl":"https://knotie-ai.pro"}' > ~/.knotie/config.json

# 3. Test the server
npx knotie-ai-mcp

# 4. Add to Claude Desktop config and restart Claude

開発者向け（ソースから）

# 1. Clone and setup
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. Configure
cp config/knotie-config.example.json config/knotie-config.json
# Edit config/knotie-config.json with your credentials

# 3. Test
npm run dev

# 4. Add to Claude Desktop with full path to build/index.js

🛠️ インストール

# 1. Install globally
npm install -g knotie-ai-mcp

# 2. Run interactive setup
npm run setup
# OR manually create config:
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"[email protected]","baseUrl":"https://knotie-ai.pro"}' > ~/.knotie/config.json

# 3. Test the server
npx knotie-ai-mcp

# 4. Add to Claude Desktop config and restart Claude

開発者向け（ソースから）

# 1. Clone and setup
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. Configure
cp config/knotie-config.example.json config/knotie-config.json
# Edit config/knotie-config.json with your credentials

# 3. Test
npm run dev

# 4. Add to Claude Desktop with full path to build/index.js

� クイックスタート

NPM ユーザー向け（推奨）

# 1. Install globally
npm install -g knotie-ai-mcp

# 2. Run interactive setup
npm run setup
# OR manually create config:
mkdir -p ~/.knotie
echo '{"apiKey":"your-key","partnerEmail":"[email protected]","baseUrl":"https://knotie-ai.pro"}' > ~/.knotie/config.json

# 3. Test the server
npx knotie-ai-mcp

# 4. Add to Claude Desktop config and restart Claude

開発者向け（ソースから）

# 1. Clone and setup
git clone https://github.com/your-username/knotie-ai-mcp.git
cd knotie-ai-mcp
npm install && npm run build

# 2. Configure
cp config/knotie-config.example.json config/knotie-config.json
# Edit config/knotie-config.json with your credentials

# 3. Test
npm run dev

# 4. Add to Claude Desktop with full path to build/index.js

🛠️ インストール

オプション 1：NPM でインストール（推奨）

# Install globally
npm install -g knotie-ai-mcp

# Or install locally
npm install knotie-ai-mcp

グローバルインストールのトラブルシューティング

グローバルインストール時に権限エラーが発生した場合は、いくつかの方法があります。

オプション A：npm の prefix フラグを使用する（推奨）

# Create a directory for global packages
mkdir -p ~/npm-packages

# Install with custom prefix
npm install --prefix ~/npm-packages -g knotie-ai-mcp

# Add to your PATH (add this line to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/npm-packages/bin:$PATH"

オプション B：npm が別のディレクトリを使用するように設定する

# Create directory and configure npm
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global

# Add to your PATH (add this line to your ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.npm-global/bin:$PATH"

# Then install
npm install -g knotie-ai-mcp

オプション C：npx を使用する（インストール不要）

# Run directly with npx
npx knotie-ai-mcp

オプション 2：ソースからインストール

# Clone the repository
git clone https://github.com/knotie-ai/knotie-ai-mcp.git
cd knotie-ai-mcp

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 設定

MCP サーバーを使用するには、Knotie AI Pro の API 認証情報が必要です。次の 2 つの方法で設定できます。

方法 1：環境変数（推奨）

Claude Desktop の設定で環境変数を直接指定します。

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/absolute/path/to/knotie-ai-mcp/build/index.js"],
      "env": {
        "KNOTIE_API_KEY": "your-api-key-here",
        "KNOTIE_PARTNER_EMAIL": "[email protected]",
        "KNOTIE_BASE_URL": "https://analytics.knotie-ai.pro"
      }
    }
  }
}

環境変数：

KNOTIE_API_KEY - パートナー API キー（必須）
KNOTIE_PARTNER_EMAIL - 登録済みのパートナーのメールアドレス（必須）
KNOTIE_BASE_URL - アナリティクスサービスのベース URL（任意。デフォルトは https://analytics.knotie-ai.pro）

メリット：

✅ 設定ファイルが不要です
✅ 認証情報は Claude Desktop 内に安全に保存されます
✅ どのインストール方法でも使用できます
✅ 他の MCP サーバー（GitHub など）と同様に使用できます

方法 2：設定ファイル（別の方法）

オプション A：NPM でインストールした場合

NPM でインストールした場合（npm install -g knotie-ai-mcp）：

設定ディレクトリを作成します：
```
mkdir -p ~/.knotie
```

設定ファイルを作成します：

# Create the config file
touch ~/.knotie/config.json

認証情報を追加します：

{
  "apiKey": "your-api-key-here",
  "partnerEmail": "[email protected]",
  "baseUrl": "https://analytics.knotie-ai.pro"
}

方法 2：ソースからインストールした場合（リポジトリをクローン）

リポジトリをクローンした場合：

設定のサンプルをコピーします：

cp config/knotie-config.example.json config/knotie-config.json

設定を編集します：

# Edit the file with your credentials
nano config/knotie-config.json
# or
code config/knotie-config.json

認証情報を更新します：

{
  "apiKey": "your-actual-api-key",
  "partnerEmail": "[email protected]",
  "baseUrl": "https://analytics.knotie-ai.pro"
}

設定ファイルの場所（優先順位順）

サーバーは次の順序で設定ファイルを検索します：

./knotie-config.json（カレントディレクトリ）
~/.knotie/config.json（ホームディレクトリ） - NPM インストール時に推奨
./config/knotie-config.json（インストール先からの相対パス） - ソースからインストールした場合

API 認証情報の取得

Knotie AI Pro パートナーダッシュボードにログインします
Settings → API Keys に移動します
新しい API キーを作成します
API キーとパートナーのメールアドレスを設定ファイルにコピーします

🔧 Claude Desktop の設定

1. Claude Desktop をインストールする

まだインストールしていない場合は、Claude Desktop をダウンロードしてインストールします。

2. Claude Desktop を設定する

Claude Desktop の設定ファイルを編集します。

macOS/Linux：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

code %APPDATA%\Claude\claude_desktop_config.json

3. Knotie AI Pro サーバーを追加する

オプション A：環境変数（推奨）

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/Users/avijitsarkar/Projects/Knotie-AI/knotie-ai-pro/knotie-ai-mcp/build/index.js"],
      "env": {
        "KNOTIE_API_KEY": "pkt_48405b5a31fec30a3be3480f7d2a56552488bb61fc81d63100ab83e8d792d3b6",
        "KNOTIE_PARTNER_EMAIL": "[email protected]",
        "KNOTIE_BASE_URL": "https://analytics.knotie-ai.pro"
      }
    }
  }
}

オプション B：設定ファイルを使用して NPM でインストール

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "npx",
      "args": ["knotie-ai-mcp"]
    }
  }
}

オプション C：設定ファイルを使用してソースからインストール

{
  "mcpServers": {
    "knotie-ai-pro": {
      "command": "node",
      "args": ["/absolute/path/to/knotie-ai-mcp/build/index.js"]
    }
  }
}

注： /absolute/path/to/knotie-ai-mcp を、リポジトリをクローンした実際のパスに置き換えてください。

なぜ index.js を使うのですか？ TypeScript のソース（src/index.ts）は、ビルド処理中に JavaScript（build/index.js）へコンパイルされます。Node.js はコンパイル済みの JavaScript ファイルを実行します。

4. Claude Desktop を再起動する

Claude Desktop を再起動して、新しい MCP サーバーを読み込みます。

🎯 利用可能なツール

システムツール

get-capabilities：システムの機能と利用可能な機能を取得します
get-health：API のヘルスステータスを確認します

顧客管理

create-customer：新しい顧客アカウントを作成します
- email（必須）：顧客のメールアドレス
- businessName（必須）：顧客の事業名
- contactName（任意）：主担当者の名前
- phone（任意）：連絡先電話番号
- subscriptionTier（任意）：starter、professional、または enterprise
enable-portal-access：顧客のポータルアクセスを有効にします
- customerEmail（必須）：顧客のメールアドレス
- sendWelcomeEmail（任意）：ウェルカムメールを送信します（デフォルト：true）
reset-customer-password：顧客のパスワードをリセットします
- customerEmail（必須）：顧客のメールアドレス
- sendEmail（任意）：パスワードリセットメールを送信します（デフォルト：true）

エージェント管理

map-agent：AI エージェントを顧客に紐付けます
- customerEmail（必須）：顧客のメールアドレス
- agentId（必須）：AI プラットフォームのエージェント ID
- platform（必須）：retell、vapi、elevenlabs、または gohighlevel
- profitMultiplier（任意）：利益乗数 1.0～10.0（デフォルト：1.5）
- agentName（任意）：エージェントのカスタム名
update-agent：エージェントの設定を更新します
- customerEmail（必須）：顧客のメールアドレス
- agentId（必須）：更新するエージェント ID
- profitMultiplier（任意）：新しい利益乗数
- agentName（任意）：新しいエージェント名
- isActive（任意）：エージェントを有効／無効にします
unmap-agent：顧客からエージェントの紐付けを解除します
- customerEmail（必須）：顧客のメールアドレス
- agentId（必須）：紐付けを解除するエージェント ID

💡 使用例

Claude Desktop での使用

設定が完了すると、Claude Desktop で自然言語のコマンドを使用できます。

"Create a new customer with email [email protected] and business name 'John's Restaurant'"

"Map a Retell agent with ID 'agent_123' to customer [email protected] with a 2.0 profit multiplier"

"Enable portal access for customer [email protected] and send them a welcome email"

"Check the health status of the Knotie AI Pro API"

コマンドラインでのテスト

サーバーを直接テストします。

# Test the server
npm run dev

# Or if installed globally
knotie-ai-mcp

🔒 セキュリティ

ローカル設定：API キーはローカルに保存され、第三者に送信されることはありません
安全な通信：すべての API 呼び出しで、適切な認証を用いた HTTPS を使用します
パートナー確認：各リクエストでパートナーのメールアドレスを確認します
データ保存なし：MCP サーバーは顧客データやエージェントデータを保存しません

🐛 トラブルシューティング

Claude Desktop にサーバーが表示されない

claude_desktop_config.json の構文を確認します
サーバーへのパスが正しいことを確認します
Claude Desktop を完全に再起動します
Claude のログを確認します：~/Library/Logs/Claude/mcp*.log

設定エラー

API キーが正しいことを確認します
パートナーのメールアドレスがアカウントと一致していることを確認します
設定ファイルがサポートされている場所にあることを確認します
設定ファイルの JSON 構文を検証します

API 接続の問題

重要： MCP サーバーはメインの Knotie AI Pro ウェブサイトではなく、Analytics Service に接続します。

正しいベース URL：

本番環境： https://analytics.knotie-ai.pro
開発環境： http://localhost:8000（分析サービスをローカルで実行している場合）

よくある問題：

404 Not Found： ベース URL が間違っています（knotie-ai.pro ではなく、analytics.knotie-ai.pro を指定してください）
Connection Refused： 分析サービスが停止しているか、URL が間違っている可能性があります
401 Unauthorized： API キーまたはパートナーのメールアドレスが無効です
403 Forbidden： 認証情報は有効ですが、権限が不足しています

デバッグ手順：

インターネット接続をテストします
ベース URL が分析サービスを指していることを確認します
API キーに必要な権限があることを確認します
パートナーアカウントが有効であることを確認します

ヘルスエンドポイントへの接続を手動で試します：

curl -H "X-API-Key: your-api-key" \
     -H "X-Partner-Email: [email protected]" \
     https://analytics.knotie-ai.pro/health

📚 ドキュメント

🤝 コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

📄 ライセンス

MIT License の詳細については、LICENSE ファイルをご覧ください。

🆘 サポート

Knotie AI Pro チームが ❤️ を込めて作成しました

Markdown 対応

ログインしてコメント

基本情報

ライセンス: MIT license
作者: avijeett007
言語: node
トランスポート: stdio
掲載日: 2025年6月4日
最終更新: 73 週間前

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Knotie AI Pro MCP Server

Knotie AI Pro MCP Server について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Knotie AI Pro MCP サーバー

🚀 機能

📋 前提条件

🚀 クイックスタート

NPM ユーザー向け（推奨）

開発者向け（ソースから）

🛠️ インストール

開発者向け（ソースから）

� クイックスタート

NPM ユーザー向け（推奨）

開発者向け（ソースから）

🛠️ インストール

オプション 1：NPM でインストール（推奨）

グローバルインストールのトラブルシューティング

オプション 2：ソースからインストール

⚙️ 設定

方法 1：環境変数（推奨）

方法 2：設定ファイル（別の方法）

オプション A：NPM でインストールした場合

方法 2：ソースからインストールした場合（リポジトリをクローン）

設定ファイルの場所（優先順位順）

API 認証情報の取得

🔧 Claude Desktop の設定

1. Claude Desktop をインストールする

2. Claude Desktop を設定する

3. Knotie AI Pro サーバーを追加する

オプション A：環境変数（推奨）

オプション B：設定ファイルを使用して NPM でインストール

オプション C：設定ファイルを使用してソースからインストール

4. Claude Desktop を再起動する

🎯 利用可能なツール

システムツール

顧客管理

エージェント管理

💡 使用例

Claude Desktop での使用

コマンドラインでのテスト

🔒 セキュリティ

🐛 トラブルシューティング

Claude Desktop にサーバーが表示されない

設定エラー

API 接続の問題

📚 ドキュメント

🤝 コントリビューション

📄 ライセンス

🆘 サポート

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？