5分でWeCom(企業WeChat)に接続するAI Agentを構築:MCPプロトコル実践チュートリアル

技术架构AI と Web プロトコル

なぜWeCom + MCP?

WeCom(企業WeChat)は中国企業の80%以上をカバー。AI AgentをWeComに接続する利点:

  • 学習コストゼロ:使い慣れたチャットインターフェースでAIを利用
  • 内蔵権限体系:WeComの組織架构と権限を再利用
  • メッセージ到達:AIが従業員やグループにプロアクティブにメッセージ送信
  • 承認統合:AIが従業員に代わって承認フローを開始

WeCom + MCP = エンタープライズAI Agentへの最短パス


アーキテクチャ

┌──────────────┐     MCP Protocol    ┌──────────────────┐     HTTP API     ┌──────────────┐
│  AI Agent    │ ◄──────────────────► │   MCP Server     │ ◄──────────────► │  WeCom API   │
│  (Claude)    │    JSON-RPC         │  (Our impl)      │    REST calls    │              │
└──────────────┘                     └──────────────────┘                   └──────────────┘

ステップ1:WeComアプリケーションの作成

WeCom管理コンソールにログイン:

1. アプリ管理 → アプリ作成
2. 認証情報を記録:
   - corpId: ww1234567890abcdef
   - agentId: 1000002
   - secret: xxxxxxxxxxxxxxxxxxxxxxxxxx
3. コールバックURL: https://your-domain.com/wecom/callback

ステップ2:MCP Serverの実装

コア依存関係

<dependencies>
    <dependency>
        <groupId>io.modelcontextprotocol</groupId>
        <artifactId>mcp-spring-boot-starter</artifactId>
        <version>0.7.0</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>3.3.0</version>
    </dependency>
</dependencies>

メッセージ送信Tool

@Component
public class SendMessageTool implements McpTool {

    @Override
    public String name() {
        return "send_message";
    }

    @Override
    public String description() {
        return "WeComを通じてメッセージを送信";
    }

    @Override
    public McpToolResult execute(Map<String, Object> args) {
        String receiverType = (String) args.get("receiverType");
        String receiverId = (String) args.get("receiverId");
        String messageType = (String) args.get("messageType");
        String content = (String) args.get("content");

        try {
            String msgId = wecomClient.sendMessage(
                receiverType, receiverId, messageType, content
            );
            return McpToolResult.success(Map.of("msgId", msgId, "status", "sent"));
        } catch (WecomApiException e) {
            return McpToolResult.error("送信失敗: " + e.getMessage());
        }
    }
}

ステップ3:Claude Desktopでの設定

{
  "mcpServers": {
    "wecom": {
      "url": "http://localhost:8081/mcp/sse",
      "transport": "sse"
    }
  }
}

本番デプロイ

FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
COPY target/wecom-mcp-server.jar app.jar
EXPOSE 8081
ENTRYPOINT ["java", "-jar", "app.jar"]

まとめ

MCPプロトコルの標準化により、MCP Serverを一度実装すれば、すべてのMCP対応AIツールで利用可能:

  1. 一度実装、どこでも利用:Claude、Cursor、カスタムAgentすべて接続可能
  2. Spring Bootエコシステム:WeCom SDK、認証、監査がすぐに利用可能
  3. 本番対応:自動トークンリフレッシュ、レート制限、監査ログ、Dockerデプロイ

これは「AIがチャットする」から「AIが働く」への最短パスです。

ブラウザローカルツールを無料で試す →

#MCP#企业微信#AI Agent#WeCom#工具调用#企业级