Team Foundation Server (TFS) Setup

Updated 2 weeks ago by Jaala


Below is a step-by-step guide on how to connect your TFS account to GitPrime. In order to make a successful connection please ensure you complete the following steps prior to Integrating with GitPrime.

  1. Whitelist GitPrime's static IP addresses on port 443 over HTTPS.
  1. Valid SSL certificate that uses a public certificate authority (CA)
  2. You also need a public DNS record pointing to the IP address that is being exposed for GitPrime analysis.

TFS Configuration

Step 1: In order to connect your TFS account, you will need to first create a new Integration. Starting on your GitPrime Home page go to the left navigation bar. At the bottom go to Settings > Integrations.

Step 2: Select the Add Integration button in the top right hand corner of you Integrations screen.

Step 3: On the following page select TFS from the Provider list.

Step 4: On this page you will need to input the following information:

  • Email - Email associated with the service account.
  • Password - Password associated with the service account.
  • Personal Access Token (see below)
  • Base URL - https://{your_TFS_domain}/{yourorganization} 

Creating a Personal Access Token

To create a personal access token in TFS follow the instructions below. 

Step 1: Locate Security under your gravatar menu.

Step 2: On the Personal access token page click Add.

Step 3: Fill in the following information for your new personal access token and click Create when finished.

  • Description
  • Expiration date
  • Scopes - Below find the minimum scopes required to connect your account.
    • Code (read)
    • Code (search)
    • Identity (read)
    • Project and team (read)
    • Service Endpoints (read and query)
    • User profile (read)
    • Work items search (read)
    • Work items (read)

Finalizing the Connection

Now that you have created a personal access token you can complete your Integration setup in GitPrime. 

Step 1: Copy your access token and paste it into the GitPrime Personal Access Token field. 

Step 2: Click Test connection

Step 3: If the connection was successful you will see the following message:

If the connection was not successful, please verify your credentials and access token and try again.

Step 4: Once you have successfully connected to your TFS account, click Next.

Step 5: On the next screen you will be selecting the services you want turned on for this Integration. If you would like to import pull request data in addition to repo data, then leave all services on. You can turn services “on” and “off” at any time. Click Next.

Step 6: Name your Integration so you can identify the account you connected with. Click Create.

Step 7: You have successfully created a new TFS Integration.

Step 8: You can begin to import your repos by going to your repo import page. Click repo import page. To learn more about managing your new Integration settings, see Managing Integrations.

Still having issues connecting your TFS account? Email us at or click on the chat icon in the bottom right corner of your screen.

How did we do?