Zoho MCP Server

Zoho統合のためのModel Context Protocol (MCP) サーバー実装です。ZohoCRM、ZohoDesk、ZohoBooksとの連携機能を提供します。

特徴

• ZohoCRM、ZohoDesk、ZohoBooksとの統合
• Model Context Protocol (MCP) 準拠
• 標準入出力ベースの通信
• シンプルな設定と実装
• クロスプラットフォーム対応

インストール

npm install @macnishio/zoho-mcp-server

環境変数の設定

以下の環境変数を設定する必要があります：

# Zoho CRM
ZOHO_CRM_CLIENT_ID=your_crm_client_id
ZOHO_CRM_CLIENT_SECRET=your_crm_client_secret
ZOHO_CRM_REDIRECT_URI=your_crm_redirect_uri
ZOHO_CRM_ACCESS_TOKEN=your_crm_access_token

# Zoho Desk
ZOHO_DESK_CLIENT_ID=your_desk_client_id
ZOHO_DESK_CLIENT_SECRET=your_desk_client_secret
ZOHO_DESK_REDIRECT_URI=your_desk_redirect_uri
ZOHO_DESK_ACCESS_TOKEN=your_desk_access_token
ZOHO_DESK_ORG_ID=your_desk_org_id

# Zoho Books
ZOHO_BOOKS_CLIENT_ID=your_books_client_id
ZOHO_BOOKS_CLIENT_SECRET=your_books_client_secret
ZOHO_BOOKS_REDIRECT_URI=your_books_redirect_uri
ZOHO_BOOKS_ACCESS_TOKEN=your_books_access_token
ZOHO_BOOKS_ORG_ID=your_books_org_id

使用方法

基本的な使用例

import { McpServer } from '@modelcontextprotocol/sdk';
import { StdioServerTransport } from '@modelcontextprotocol/sdk';

// サーバーの起動
const server = new McpServer(methods);
const transport = new StdioServerTransport();
await server.connect(transport);

ClaudeDesktopとの連携

ClaudeDesktopアプリケーションでMCPサーバーとして実行する場合：

{
  "mcpServers": {
    "zoho-integrated": {
      "command": "node",
      "args": ["path/to/server.mjs"],
      "cwd": "path/to/working/directory",
      "stdio": {
        "stdout": "pipe",
        "stderr": "pipe"
      }
    }
  }
}

サポートされているメソッド

getConnectionStatus()

各Zohoサービスとの接続状態を確認します。

const status = await methods.getConnectionStatus();
// 戻り値: { crm: boolean, desk: boolean, books: boolean }

getInvoices(params)

Zoho Booksから請求書データを取得します。

const invoices = await methods.getInvoices({
  orgId: 'your_organization_id',
  filters: {
    // オプションのフィルター
  }
});

開発

セットアップ

git clone https://github.com/macnishio/zoho-mcp-server.git
cd zoho-mcp-server
npm install

ビルド

npm run build

テスト

npm test

ライセンス

ISC

貢献

バグ報告や機能リクエストは、GitHubのIssueを通じてお知らせください。

作者

macnishio