Sinch Conversations — VS Code Extension

Accelerate onboarding and streamline day‑to‑day development with the Sinch Conversations API directly inside VS Code. This extension gives you an integrated workspace to configure credentials, manage senders, create & test webhooks, and send SMS without leaving your editor. It is purpose-built for developers adopting Sinch and for ongoing integration support.

Official API docs: https://developers.sinch.com/docs/conversation/

Features

Core Explorer Views

• Senders: Browse and add conversation senders
• Messages: See SMS sent within the last ~2 hours and send new messages
• Webhooks: Manage all registered webhooks
• Configuration: Inspect currently active Sinch credentials

Webhook Lifecycle Management

• Create, edit, delete webhooks
• Copy webhook ID or fully resolved callback URL
• Trigger simulated events and run test payloads using built‑in HTML templates

Messaging & Senders

• Load and manage available senders for your app
• Send SMS quickly from the Messages view (context menu or title actions)

Credential & Environment Configuration

• Guided command to set Key ID, Secret, Project ID, App ID & Region
• Fast switching of App ID / Region for multi‑environment testing

AI / MCP Enablement

• Optional generation of AI agent configuration files for compatible IDE assistants (Copilot, Cursor, Windsurf)
• MCP server integration (see section below)

Developer Experience Extras

• Lightweight HTML templates for webhook testing & trigger simulation
• Structured command palette integration & contextual menus

Installation

Install from the VS Code Marketplace (recommended) or manually via a packaged VSIX file.

Usage

1. Open the Sinch Conversations View

Click the activity bar icon ("Sinch Conversations"). You will see views for Senders, Messages, Webhooks, and Configuration.

2. Configure Credentials (First Run)

Open the Command Palette (⇧⌘P / Ctrl+Shift+P) and run: "Sinch Conversations: Configure Sinch API". Provide:

• Key ID
• Key Secret
• Project ID
• App ID
• Region (us | eu)

Once saved, the extension initializes and begins loading senders, webhooks, and recent messages. If credentials are incomplete you will be prompted to configure them.

3. Explore & Act

• Configuration view: verify what is currently set.
• Senders view: refresh or add a sender via the title menu/context menu.
• Messages view: refresh recent messages or send a new SMS directly.
• Webhooks view: create, edit, delete, refresh, copy IDs/URLs, and test triggers.

Contextual actions are exposed through:

• View title bar buttons (Refresh, Send, etc.)
• Right‑click context menus on items (Edit, Delete, Copy ID, Copy URL, Test Trigger)
• Command Palette for any action (search "Sinch Conversations")

4. Switching Apps or Regions

Use the relevant selection commands from the Command Palette to rapidly change App ID or Region. This is useful for staging vs production testing.

5. Webhook Testing

Selecting a webhook test action will open an HTML template in the editor, allowing you to simulate inbound requests or trigger events. Adjust payloads and re‑run as needed.

6. Optional AI Agent Configuration

On successful credential setup, you may be prompted to auto‑generate AI agent configuration to enhance Chat experiences. Accept to create recommended files; decline to skip. You can trigger generation later via the Command Palette.

For a complete list of contribution points and commands, refer to package.json or the VS Code Command Palette.

Tip: Nearly every action surfaces in three places: tree view item context menus, view title menus, and the Command Palette—use whichever is fastest for your workflow.

MCP (Model Context Protocol) Integration

This extension supports MCP integration for AI assistants in VS Code, Cursor, and Windsurf IDEs. The MCP server provides AI assistants with access to Sinch Conversations API functions.

Setup MCP

1. Configure Sinch credentials first using the Configure Sinch API command
2. Add Sinch MCP using the command Sinch Conversations: Add Sinch MCP

The extension will automatically create the appropriate MCP configuration file for your IDE:

• VS Code: .vscode/mcp.json (in your workspace)
• Cursor: ~/.cursor/mcp.json (in your home directory)
• Windsurf: ~/.codeium/windsurf/mcp_config.json (in your home directory)

IDE-Specific MCP Setup Instructions

VS Code

• MCP server will be configured automatically
• Activation: Open Copilot Chat and allow the MCP server when prompted
• The MCP integration will start working immediately after allowing

Cursor

• MCP server starts automatically after configuration
• If MCP gets disconnected:
  • Go to Cursor Settings → Features → Model Context Protocol
  • Enable the "sinch" MCP server
  • Or restart Cursor if the server doesn't appear

Windsurf

• MCP server requires manual activation after configuration
• Activation steps:
  1. Open Windsurf Settings
  2. Go to Features → Model Context Protocol
  3. Click the reload/refresh button next to MCP settings
  4. Or reload the full Windsurf window (Cmd/Ctrl + R)
  5. Enable the "sinch" MCP server

Available MCP Commands

• Sinch Conversations: Add Sinch MCP - Configures MCP for your current IDE
• Sinch Conversations: Remove Sinch MCP - Removes MCP configuration

Troubleshooting MCP

MCP server not appearing in IDE settings?

• Ensure you've configured Sinch credentials first
• Try reloading/restarting your IDE after adding MCP config
• Check that the MCP config file was created in the correct location

MCP shows as "disconnected" in Cursor?

• Go to Settings → Features → Model Context Protocol
• Toggle the "sinch" server off and on again
• Restart Cursor if the issue persists

MCP not working in Windsurf?

• Always reload the window or click refresh in MCP settings after configuration
• Check that the config file exists at ~/.codeium/windsurf/mcp_config.json

Verify MCP Integration is Working

Once you've set up MCP, you can verify it's working by testing with your AI assistant:

Simple verification:

• Ask AI: "What MCP tools are available?" or "List available tools"
• The AI should show Sinch Conversations API functions

Test Sinch functionality:

• Ask AI: "Can you help me send an SMS using Sinch?"
• Ask AI: "Show me all conversation apps"

If the AI responds with Sinch-specific capabilities or mentions Sinch tools, your MCP integration is working correctly. If the AI doesn't recognize Sinch tools, refer to the troubleshooting section above.

Telemetry

This extension collects minimal usage telemetry solely to improve developer experience. It honors VS Code's global telemetry setting: if telemetry is disabled globally, no data is collected.

Development

Built with TypeScript and the VS Code Extension API.

Contributing

Contributions welcome. Please run npm run check (lint + compile) before committing and follow formatting rules (Prettier + ESLint). Open an issue or merge request with clear reproduction or proposal context.

License

See LICENSE.md.

Changelog

Release notes are maintained in CHANGELOG.md.

Further Reading

Developer Documentation: https://developers.sinch.com/docs/conversation/

If you have feature requests or find issues during onboarding, please share feedback to help evolve the extension. From all of us at Sinch, happy coding!