Self-hosted Teamso MCP

Hızlı başlangıç

Node.js 20 ya da üstü gerekir. MCP istemcinizin yapılandırmasına ekleyin:

{
  "mcpServers": {
    "teamso": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@teamso/[email protected]"
      ],
      "env": {
        "TEAMSO_ACCESS_TOKEN": "tms_pat_..."
      }
    }
  }
}

Sürüm sabittir; böylece npx önbellekteki eski bir sürümü çalıştırmaz.

Kurulum

Paket stdio üzerinden çalışır; stdio destekleyen her MCP istemcisiyle kullanılır.

Cursor

Cmd+Shift+P → Open MCP settings ile ~/.cursor/mcp.json dosyasını açın ve ekleyin:

{
  "mcpServers": {
    "teamso": {
      "command": "npx",
      "args": [
        "-y",
        "@teamso/[email protected]"
      ],
      "env": {
        "TEAMSO_ACCESS_TOKEN": "tms_pat_..."
      }
    }
  }
}

Claude Code

Token'ı ortam değişkeni olarak vererek ekleyin:

claude mcp add teamso --env TEAMSO_ACCESS_TOKEN=tms_pat_... -- npx -y @teamso/[email protected]

Claude Desktop

claude_desktop_config.json dosyasına ekleyin ve Claude Desktop'u yeniden başlatın:

{
  "mcpServers": {
    "teamso": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@teamso/[email protected]"
      ],
      "env": {
        "TEAMSO_ACCESS_TOKEN": "tms_pat_..."
      }
    }
  }
}

Windsurf

Windsurf → Settings → MCP yapılandırmasına ekleyin:

{
  "mcpServers": {
    "teamso": {
      "command": "npx",
      "args": [
        "-y",
        "@teamso/[email protected]"
      ],
      "env": {
        "TEAMSO_ACCESS_TOKEN": "tms_pat_..."
      }
    }
  }
}

Diğer istemciler

Stdio destekleyen her istemci şu komutu çalıştırabilir; token TEAMSO_ACCESS_TOKEN ortam değişkeninden okunur:

TEAMSO_ACCESS_TOKEN=tms_pat_... npx -y @teamso/[email protected]

Kimlik doğrulama

Paket tek bir kimlik bilgisi kullanır: Teamso'da MCP erişimi sayfasından oluşturduğunuz kişisel erişim token'ı. Token'ı TEAMSO_ACCESS_TOKEN değişkenine yazın; paket her isteğe Authorization: Bearer başlığı olarak ekler.

TEAMSO_ACCESS_TOKEN=tms_pat_...

Yerel pakette istekler sizin IP adresinizden gelir; şirketinizde IP kısıtlaması varsa bu adres izinli olmalı. Yetkiler, token'la yapılamayan işlemler ve iptal kuralları hosted sunucuyla aynıdır.

Hosted MCP sunucusu · Kimlik doğrulama

Araçlar

Paket hosted sunucuyla aynı 34 aracı sunar. Tabloda her aracın çağırdığı Teamso REST ucu (TEAMSO_API_BASE_URL'e göre) yer alır; yardım araçları API yerine herkese açık kılavuz paketini okur.

Paket 1.2.0'dan beri genel API araçlarıyla (find_api_endpoints, call_api_read, call_api_write...) yetkinizin açtığı tüm modüllerde çalışır. Akış, güvenlik kuralları ve örnekler hosted sunucu sayfasındadır.

Hosted MCP sunucusu · Tüm modüller

Prompt'lar paketin 1.1.0 sürümünde eklendi ve createMcpServer bunları araçlarla birlikte kaydeder. Kendi sunucunuzda registerPrompts ve PROMPT_NAMES dışa aktarımlarını (@teamso/teamso-mcp/prompts) kullanabilirsiniz.

Ortam değişkenleri

Paket şu ortam değişkenlerini okur:

TEAMSO_TOOLSETS=core,leave,api

GitHub ve npm

Kaynak kod MIT lisansıyla GitHub'da, paket npm'de yayımlanır.

• GitHub: Teamsocom/Teamso-MCP
• npm: @teamso/teamso-mcp

Kütüphane olarak kullanım

Paket, kendi MCP sunucunuzu kurmanız için çekirdek parçalarını dışa aktarır:

import { TeamsoClient } from "@teamso/teamso-mcp/client";
import { createMcpServer } from "@teamso/teamso-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const client = new TeamsoClient(process.env.TEAMSO_ACCESS_TOKEN!, "https://api.teamso.com/v1");
const server = createMcpServer(client, { name: "my-teamso-assistant" });

await server.connect(new StdioServerTransport());

Dışa aktarılanlar

Parçaları ayrı ayrı da içe aktarabilirsiniz:

import { TeamsoClient } from "@teamso/teamso-mcp/client";
import { registerTools, TOOL_NAMES } from "@teamso/teamso-mcp/tools";

registerTools(existingMcpServer, new TeamsoClient(token));
console.log(TOOL_NAMES); // ["search_help_articles", "get_help_article", ...]

Başkalarının isteklerini ileten bir sunucu, Teamso'nun şirket IP kısıtlamasını ve denetim kaydını gerçek kullanıcıya uygulaması için çağıranın IP'sini imzalayabilir. Gizli anahtar API'deki security.mcp-proxy.shared-secret ile aynı olmalı (en az 32 karakter):

const client = new TeamsoClient(userToken, "https://api.teamso.com/v1", {
  trustedProxy: { clientIp: request.ip, sharedSecret: process.env.TEAMSO_MCP_PROXY_SECRET! },
});

Kendi sunucunuzda

Kaynaktan derleyip kendi sunucunuzda çalıştırın (Node.js 20+):

git clone https://github.com/Teamsocom/Teamso-MCP.git
cd Teamso-MCP
npm ci
npm run build
export TEAMSO_ACCESS_TOKEN=tms_pat_...
node dist/index.js

İstemcinizi npx yerine bu derlemeye yönlendirin:

{
  "mcpServers": {
    "teamso": {
      "command": "node",
      "args": [
        "/absolute/path/to/Teamso-MCP/dist/index.js"
      ],
      "env": {
        "TEAMSO_ACCESS_TOKEN": "tms_pat_..."
      }
    }
  }
}

Paket kurulurken kendini derler (prepare), bu yüzden etiketli bir sürüm doğrudan GitHub'dan da kurulabilir:

npm install github:Teamsocom/Teamso-MCP#v1.2.1