MCP

🚀 Upnify MCP Server (Python)

Upnify MCP Server (Python)は、Pythonで書かれたModel Context Protocol (MCP)サーバーです。このサーバーは、AIアシスタントやLLMに対して、Upnify CRMの機能（見込み客管理、商談追跡、販売レポートなど）への直接アクセスを提供します。

🚀 クイックスタート

Upnify MCP Server (Python)を使用することで、AIアシスタントやLLMがUpnify CRMの機能を利用できるようになります。以下のセクションでは、インストール方法、設定方法、使用方法などを説明します。

✨ 主な機能

• 見込み客管理：Upnify CRM内で見込み客を作成および検索します。
• 連絡先検索：名前、メールアドレス、または電話番号で連絡先を検索します。
• リマインダー管理：カレンダーのリマインダーとタスクを作成します。
• 販売レポート：販売データと分析情報にアクセスします。
• 活動レポート：チームの活動とパフォーマンスを追跡します。
• 簡単な統合：Claude Desktop、Open-LLM-VTuber、およびその他のMCPクライアントと互換性があります。

📦 インストール

PyPIからのインストール

pip install upnify-mcp-server

ソースからのインストール

git clone https://github.com/adrielisa/MCP.git
cd MCP/python-package
pip install -e .

🔧 設定

環境変数の設定

Upnifyの統合トークンを環境変数として設定します。

export TK_INTEGRACION="your-upnify-integration-token"

または、.envファイルを作成します。

TK_INTEGRACION=your-upnify-integration-token

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。 Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "upnify": {
      "command": "upnify-mcp-server",
      "env": {
        "TK_INTEGRACION": "your-upnify-integration-token"
      }
    }
  }
}

💻 使用例

コマンドラインからの起動

サーバーを直接起動します。

upnify-mcp-server

利用可能なツール

サーバーは、AIアシスタントに以下のツールを提供します。

基本的な使用法

# 見込み客の作成
{
  "name": "create-upnify-prospect",
  "arguments": {
    "nombre": "John",
    "apellidos": "Doe", 
    "correo": "john.doe@example.com",
    "telefono": "+1234567890",
    "empresa": "Acme Corp"
  }
}

# 連絡先の検索
{
  "name": "search-upnify-contacts",
  "arguments": {
    "buscar": "john.doe@example.com",
    "cantidadRegistros": 10
  }
}

# リマインダーの作成
{
  "name": "create-upnify-reminder",
  "arguments": {
    "asunto": "Follow up with John Doe",
    "descripcion": "Call to discuss proposal",
    "fechaInicio": "2025-08-07 10:00"
  }
}

高度な使用法

# Open-LLM-VTuberとの統合
import asyncio
from mcp.client.session import ClientSession
from mcp.client.stdio import stdio_client

async def use_upnify_mcp():
    async with stdio_client(["upnify-mcp-server"]) as (read, write):
        async with ClientSession(read, write) as session:
            # 初期化
            await session.initialize()
            
            # 利用可能なツールの一覧を取得
            tools = await session.list_tools()
            print(f"Available tools: {len(tools.tools)}")
            
            # 見込み客を作成
            result = await session.call_tool(
                "create-upnify-prospect",
                {
                    "nombre": "Jane",
                    "correo": "jane@example.com"
                }
            )
            print(f"Result: {result}")

# サンプルを実行
asyncio.run(use_upnify_mcp())

📚 ドキュメント

統合例

Open-LLM-VTuberとの統合

conf.yamlに以下を追加します。

tool_config:
  mcp_servers:
    upnify:
      command: ["upnify-mcp-server"]
      env:
        TK_INTEGRACION: "your-token-here"

カスタムPythonコードとの統合

import asyncio
from mcp.client.session import ClientSession
from mcp.client.stdio import stdio_client

async def use_upnify_mcp():
    async with stdio_client(["upnify-mcp-server"]) as (read, write):
        async with ClientSession(read, write) as session:
            # 初期化
            await session.initialize()
            
            # 利用可能なツールの一覧を取得
            tools = await session.list_tools()
            print(f"Available tools: {len(tools.tools)}")
            
            # 見込み客を作成
            result = await session.call_tool(
                "create-upnify-prospect",
                {
                    "nombre": "Jane",
                    "correo": "jane@example.com"
                }
            )
            print(f"Result: {result}")

# サンプルを実行
asyncio.run(use_upnify_mcp())

📋 必要条件

• Python 3.8以上
• APIアクセスが可能なUpnify CRMアカウント
• Upnifyからの統合トークン

🔧 技術詳細

• セキュリティに関しては、統合トークンをスクリプトにハードコードしないでください。環境変数または安全なクレデンシャル管理を使用してください。
• Upnify APIにデータを送信する前に、すべての入力データを検証してください。
• APIの使用状況とレート制限を監視してください。

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

一般的な問題

認証エラー

Error: Token de integración inválido

• TK_INTEGRACION環境変数を確認してください。
• トークンが期限切れになっていないことを確認してください。
• トークンに問題がある場合は、Upnifyサポートに問い合わせてください。

接続タイムアウト

Error: Timeout connecting to Upnify API

• インターネット接続を確認してください。
• Upnify APIのステータスを確認してください。
• 必要に応じてタイムアウト値を増やしてください。

権限エラー

Error: Access denied for resource

• Upnifyアカウントの権限を確認してください。
• 統合トークンが必要なスコープを持っていることを確認してください。

デバッグモード

デバッグログを有効にして実行します。

export UPNIFY_DEBUG=1
upnify-mcp-server

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

🔗 関連プロジェクト

• Upnify CRM - 顧客関係管理プラットフォーム
• Model Context Protocol - AIアプリケーション統合のオープン標準
• Claude Desktop - MCPをサポートするAIアシスタント

📞 サポート

• 📧 メール: tu-email@ejemplo.com
• 🐛 問題報告: GitHub Issues
• 📖 ドキュメント: GitHub Wiki

Made with ❤️ for the AI and CRM community