Autotaskmcp

🚀 ここから始めよう - Autotask MCP サーバー

Autotask MCPサーバーを使って、Claudeと連携した業務自動化を実現します。

🚀 クイックスタート

🎯 クイックセットアップ（5分）

ステップ1: 依存関係のインストール

pip install mcp httpx pydantic

ステップ2: 接続のテスト

python test_autotask_connection.py

認証情報を入力してください: （独自の認証情報を入力する必要があります）

• ユーザー名: username@domain.com
• シークレット: 1234567890
• 統合コード: 12345678
• API URL: https://webservices[x].autotask.net/ATServicesRest/v1.0 (もしあなたが ww16.autotask.net を使用している場合、webservices[x] は webservices16.autotask.net になります)

期待される結果:

✅ 認証に成功しました！
✅ サンプル企業を取得しました: [名前]
✅ チケットへのアクセスに成功しました！

ステップ3: Claude Desktopの設定

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

以下を追加してください:

{
  "mcpServers": {
    "autotask": {
      "command": "python",
      "args": ["/FULL/PATH/TO/autotask_mcp.py"],
      "env": {
        "AUTOTASK_USERNAME": "your-username@company.com",
        "AUTOTASK_SECRET": "your-api-secret-here",
        "AUTOTASK_INTEGRATION_CODE": "your-integration-code-here",
        "AUTOTASK_API_URL": "https://webservices5.autotask.net/ATServicesRest/v1.0"
      }
    }
  }
}

ステップ4: Claude Desktopを再起動する

Claude Desktopを完全に終了して再起動してください。

ステップ5: 使用を開始する

Claudeで以下のコマンドを試してみてください:

• "すべての未処理のチケットを表示して"
• "会社12345についてのメールの問題でチケットを作成して"
• "名前に 'Tech' が含まれる会社を検索して"

✨ 主な機能

チケット管理

• フィルターを使ったチケットの検索
• 特定のチケットの詳細情報の取得
• 新しいチケットの作成
• チケットのステータス/優先度/担当者の更新
• チケットへのメモの追加

会社管理

• 会社名での会社の検索
• 会社の詳細情報の取得

連絡先管理

• 会社/メールアドレス/名前での連絡先の検索
• 連絡先の情報の取得

応答形式

• Markdown - 人間が読みやすい形式（デフォルト）
• JSON - 自動化に適した機械可読形式

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

"認証に失敗しました"

• 認証情報が正しいことを確認してください。
• 余分な空白がないことを確認してください。
• APIユーザーが適切なセキュリティレベルを持っていることを確認してください。

"リソースが見つかりません"

• IDが存在することを確認してください。
• ユーザーがそのリソースにアクセスする権限を持っていることを確認してください。

"MCPサーバーが表示されません"

• 設定ファイルのJSON構文を確認してください。
• .pyファイルの絶対パスが正しいことを確認してください。
• Claude Desktopを完全に再起動してください。
• ~/Library/Logs/Claude/ のログを確認してください。

"405 Method Not Allowed"

• 古いバージョンを使用している可能性があります。ファイルを再ダウンロードしてください。

📚 ドキュメント

• QUICKSTART.md - 快速セットアップガイド
• README.md - 包括的なドキュメント

🌟 特徴

✅ 8つのツール - 完全なチケット、会社、および連絡先管理 ✅ ヘッダー認証 - シンプルなユーザー名/シークレット/統合コード ✅ エラーハンドリング - 明確で実行可能なエラーメッセージ ✅ ベストプラクティス - MCP Python SDKの標準に準拠 ✅ 本番環境対応 - 非同期処理、検証済み、型ヒント付き ✅ 充実したドキュメント - 包括的なガイドとサンプル

🎉 準備完了！

1. ✅ ファイルをダウンロードする
2. ✅ 接続をテストする
3. ✅ Claude Desktopを設定する
4. ✅ ClaudeでAutotaskの管理を開始する！

質問がありますか？ 詳細なヘルプはREADME.mdを確認するか、support@sondelaconsulting.comまでお問い合わせください。

問題が発生しましたか？ テストスクリプトが正確な問題を教えてくれます。

Made with ❤️ by Sondela Consulting

あなたのPSAワークフローをClaudeのインテリジェンスに接続する