acculynx-automation

acculynx-automation skill の概要

acculynx-automation でできること

acculynx-automation は、Composio の Rube MCP server を通じて Acculynx の作業を自動化するための Claude skill です。単体で動作する Acculynx API ラッパーではありません。エージェントが RUBE_SEARCH_TOOLS で現在利用できる Acculynx tool schema を確認し、RUBE_MANAGE_CONNECTIONS で有効な Acculynx 接続を検証したうえで、依頼されたワークフローに適した Rube MCP tools を実行できるように導きます。

Composio toolkit 経由で AI エージェントに Acculynx の操作を任せたい一方で、schema の推測や古い tool 情報によるエラーを減らしたい場合に、この acculynx-automation skill が役立ちます。

向いているユーザーとワークフロー

acculynx-automation skill は、すでに Claude または MCP 対応クライアントを使っていて、Acculynx のタスクを再現性高く実行したいチームに向いています。たとえば、屋根工事、建設、CRM、オペレーション関連のチームが、レコード検索、ワークフロー手順の準備、Rube 経由での tool call 調整など、構造化された Acculynx 操作を自動化したい場合に適しています。

利用可能な Acculynx action が変わる可能性がある環境では特に有用です。この skill の基本動作は、固定パラメータを前提にせず、まず tool を検索することだからです。

主な違い: まず schema を確認する設計

実務上の大きな価値は、必ず discovery を先に行うというパターンにあります。操作を始める前に、エージェントはユーザーの具体的な Acculynx 用途に対して RUBE_SEARCH_TOOLS を呼び出す必要があります。これにより、利用可能な tool slug、input schema、推奨される実行計画、注意点が返されます。

そのため acculynx-automation は、モデルに「Acculynx を使って」と頼むだけの通常のプロンプトよりも信頼性が高くなります。実行内容が、現在の Rube MCP tool catalog に基づくためです。

導入前に確認すべき要件

Workflow Automation 用に acculynx-automation をインストール、または本格利用する前に、次の 3 点を確認してください。利用するクライアントが MCP に対応していること、Rube MCP が https://rube.app/mcp で設定されていること、そして toolkit acculynx を指定した RUBE_MANAGE_CONNECTIONS により Acculynx 接続を ACTIVE にできることです。

いずれかが欠けている場合でも、この skill はワークフローの説明はできます。ただし、Acculynx の実操作を実行することはできません。

acculynx-automation skill の使い方

acculynx-automation のインストール前後の前提

skill manager を使って、Composio skill collection から skill をインストールします。例:

npx skills add ComposioHQ/awesome-claude-skills --skill acculynx-automation

次に、MCP 対応クライアントで server endpoint を追加し、Rube MCP を設定します。

https://rube.app/mcp

上流の skill には補助スクリプトや追加の参照ファイルは含まれていません。そのため、確認すべき重要なソースは composio-skills/acculynx-automation/SKILL.md です。このファイルには、必要な MCP dependency、接続ワークフロー、そして「まず tool を検索する」というルールが定義されています。

skill に渡すべき入力情報

acculynx-automation を精度よく使うには、ざっくりした命令だけでなく、より具体的な情報をエージェントに渡してください。業務タスク、対象となる Acculynx object またはワークフロー領域、既知の identifier、制約、そしてエージェントに計画だけをさせるのか実行までさせるのかを含めると効果的です。

弱いプロンプト: “Update Acculynx.”

より良いプロンプト: “Use acculynx-automation to find the current Acculynx tools for updating a job record. First confirm the acculynx connection is ACTIVE. Then identify the required schema for updating job status. Do not execute the update until you show me the required fields and ask for confirmation.”

この書き方が有効なのは、tool discovery で何を探すべきか、実行をどの程度慎重に行うべきか、どこで確認を求めるべきかが明確になるためです。

初回実行時のおすすめワークフロー

最初は業務アクションではなく、接続確認から始めてください。エージェントに RUBE_SEARCH_TOOLS が利用可能か確認させ、その後 toolkit acculynx を指定して RUBE_MANAGE_CONNECTIONS を使わせます。接続が active でない場合は、返された authorization link に従い、確認を再実行します。

その後、実行したい具体的な作業に対して discovery を行います。たとえば “search Acculynx customers”、“retrieve project details”、“prepare an Acculynx update workflow” などです。エージェントは必要に応じて返された session ID を再利用し、tool schema を確認してから、実行用 tool を呼び出すべきです。

実用的なプロンプトの型

信頼しやすい acculynx-automation 用の指示は、次のような形です。

• “Search Rube tools for this exact Acculynx task: [task].”
• “Check whether the acculynx toolkit connection is ACTIVE.”
• “Show the tool slug, required inputs, optional inputs, and any pitfalls.”
• “If execution is safe, perform [action]; otherwise ask me for missing fields.”
• “Do not invent field names; use the schema returned by RUBE_SEARCH_TOOLS.”

この型により、認証が整う前に操作してしまうことと、Acculynx tool parameter を推測で作ってしまうことという、2 つの大きな失敗パターンを減らせます。

acculynx-automation skill FAQ

Rube MCP なしで acculynx-automation は使えますか？

いいえ。この skill は Rube MCP と Composio Acculynx toolkit に依存しています。RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS がなければ、実質的には手順書にとどまります。エージェントに Rube MCP tools を公開できる環境でのみ、インストールを検討してください。

通常の Acculynx プロンプトと何が違いますか？

通常のプロンプトでは、モデルが API や連携機能について記憶している情報に頼ってしまうことがあります。一方、acculynx-automation skill は、まず live tool schema を確認し、有効な接続をチェックし、Rube MCP 経由で実行するようエージェントに指示します。

Acculynx 自動化では、この違いが重要です。tool 名、必須フィールド、認証状態といった運用上の詳細は、汎用的なプロンプトでは見落とされがちだからです。

初心者にも向いていますか？

はい。ただし、MCP server の設定と authentication link の手順に抵抗がないことが前提です。skill のワークフロー自体はシンプルですが、tool call が実際の Acculynx データに影響を与えうることを理解している必要があります。

初めて使う場合は、読み取り専用または確認優先のモードから始めるのが安全です。まず tool を確認し、schema を点検し、書き込み変更の前に確認を求める運用にしてください。

この skill を使わないほうがよいケースは？

オフラインのドキュメントだけが必要な場合、独自の API 開発を直接行いたい場合、Composio toolkit 外の未対応 Acculynx action が必要な場合、またはレビューなしで完全自律的な書き込みを行いたい場合は、acculynx-automation を使うべきではありません。

また、組織として Rube MCP 経由の Acculynx アクセスを承認できない場合にも適していません。

acculynx-automation skill を改善する方法

タスク範囲を明確にして acculynx-automation の結果を改善する

この skill は、依頼するユースケースが具体的なほど良い結果を出します。“manage a claim” ではなく “discover tools for retrieving an Acculynx job by ID and checking its current status” と伝えてください。“sync customers” ではなく “find whether Acculynx tools can search customers by email and return customer IDs” と指定します。

具体的なユースケースほど、RUBE_SEARCH_TOOLS の結果が改善され、実行計画も整理されます。

書き込み操作には確認ルールを追加する

より安全に workflow automation を行うには、discovery、planning、execution を明確に分けてください。レコード作成、job status の更新、contact の変更、別システムへのデータ送信など、承認が必要な操作をエージェントに明示します。

実用的なルール例は次のとおりです。“Read operations may run after schema discovery; write operations require a summary of intended changes and my approval.”

よくある失敗パターンに注意する

よくある問題は、Acculynx 接続が inactive のままになっていること、tool discovery を省略すること、schema field を推測で作ること、プロンプトが広すぎることです。

出力が不確かに見える場合は、より狭いユースケースで RUBE_SEARCH_TOOLS を再実行し、返された schema から required fields を引用してから続行するようエージェントに依頼してください。

初回出力のあとにプロンプトを更新する

最初の acculynx-automation 実行後は、エージェントが得た情報を使ってプロンプトを改善してください。具体的には、tool slug、必要な identifier、不足している field、返された注意点などです。

繰り返し使うワークフローでは、接続確認、schema discovery、確認が必要な境界、期待する出力形式を含めた再利用可能な prompt template を保存しておくとよいでしょう。これにより、この skill は単発の自動化ヘルパーではなく、より信頼できる Acculynx の運用手順として使えるようになります。