API連携ベストプラクティス

{
  "name": "search_documents",
  "description": "Search documents by keyword and return matching results",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search keyword or phrase"
      },
      "limit": {
        "type": "number",
        "description": "Max number of results (default: 10)",
        "default": 10
      }
    },
    "required": ["query"]
  }
}

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token-here"
      }
    }
  }
}

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch(url, options);
      if (response.status === 429 || response.status >= 500) {
        throw new Error(`HTTP ${response.status}`);
      }
      return response;
    } catch (error) {
      if (attempt === maxRetries) throw error;
      // Exponential backoff with jitter
      const baseDelay = Math.pow(2, attempt) * 1000;
      const jitter = Math.random() * baseDelay;
      await new Promise(r => setTimeout(r, baseDelay + jitter));
    }
  }
}

// Abstract provider interface
interface NotificationProvider {
  send(message: string, channel: string): Promise<void>;
  getChannels(): Promise<Channel[]>;
}

// Slack implementation
class SlackProvider implements NotificationProvider {
  async send(message: string, channel: string) {
    await this.client.chat.postMessage({ channel, text: message });
  }
}

// LINE implementation
class LineProvider implements NotificationProvider {
  async send(message: string, channel: string) {
    await this.client.pushMessage({ to: channel, messages: [{ type: "text", text: message }] });
  }
}

// Usage - easily swap providers
const provider = getProvider(config.notificationService);
await provider.send("Deploy completed!", "#releases");